Kiterjesztés:Bábel
Babel Kiadási állapot: stabil |
|
---|---|
Megvalósítás | Parser function |
Leírás | Lehetővé teszi a felhasználók nyelvtudásának megadását és kategorizálását egy értelmezőfüggvénnyel. |
Szerző(k) | Robert Leverington (RobertLvitalap) |
Legfrissebb verzió | Continuous updates |
Kompatibilitási irányelv | Master maintains backward compatibility. |
MediaWiki | >= 1.41.0 |
Adatbázis-változtatások | Igen |
Composer | mediawiki/babel |
Táblák | babel |
Licenc | GNU General Public License 2.0 or later |
Letöltés | A Language Extension Bundle részeként |
Példa | Translatewiki.net |
|
|
Quarterly downloads | 71 (Ranked 72nd) |
Public wikis using | 2,416 (Ranked 192nd) |
Fordítsd le a(z) Babel kiterjesztést, ha elérhető a translatewiki.net oldalon | |
Problémák | Nyitott feladatok · Hibajelentés |
A Bábel kiterjesztés a sablonokkal működő régi rendszert egy értelmezőfüggvényen alapulóra cseréli. Ismeretlen nyelvparaméter megadásakor az adott nevű sablont illeszti be, ha az létezik.
On Wikimedia projects, the noun Babel (in reference to the Tower of Babel) refers to the texts on user pages aiding multilingual communication by making it easier to contact someone who speaks a certain language. The idea originated on the Wikimedia Commons and has also been implemented on many other wikis.
Telepítés
- Töltsd le a kiterjesztés fájljait, és mentsd el az
extensions/
mappán belüliBabel
könyvtárba.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel - Add hozzá az alábbi kódot a LocalSettings.php fájlod aljára:
wfLoadExtension( 'Babel' );
- Futtasd le a frissítőszkriptet, ami automatikusan létrehozza a kiterjesztés által igényelt táblákat az adatbázisban.
- Konfiguráld igény szerint.
- Kész – A Special:Version oldalon ellenőrizheted, hogy a kiterjesztés ténylegesen feltelepült-e.
- A CSS a
resources/ext.babel.css
fájlban található. Megváltoztathatod akaratod szerint aMediaWiki:Common.css
megfelelő sorainak felülírásával. - Ha a CLDR kiterjesztés telepítve van, annak a nyelvneveit használja a Babel (ahol nem érhető el fordítás), egyébként a beépített MediaWiki-nyelvneveket és az angol alapértelmezéseket jeleníti meg.
Használat
Syntax for the #babel
parser function is as follows:
{{#babel: babelcode1 | babelcode2 | ... }}
Add one of the following codes for each language you speak or understand, separated by |
, where xx
is the MediaWiki language code, ISO 639-1 code, or ISO 639-3 code for the language. The general usage of each code level is as follows:
xx-0
- Ha egyáltalán nem érted a nyelvet.
xx-1
: Basic ability—enough to understand written material or simple questions in this language.xx-2
: Intermediate ability—enough for editing or discussions.xx-3
: Advanced level—though you can write in this language with no problem, some small errors might occur.xx-4
: "Near-native" level—although it's not your first language from birth, your ability is something like that of a native speaker.xx-5
: Professional proficiency.xx
orxx-N
: Native speakers who use a language every day and have a thorough grasp of it, including colloquialisms and idioms.
To include any other template, add the name of the template, e.g., add User CSS
if you want to include Template:User CSS
. A prefix or suffix may be added to template names (e.g., User
at the beginning) depending on the local configuration. This can be used to restrict the selection and reduce the length of parameters; for example, CSS
could include Template:User CSS
if configured in such a way.
Parameters
To remove the header and footer, use plain=1
as the first parameter, e.g., {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}
.
This makes it easier to use Babel with other userboxes.
To hide categories, use the nocat=1
parameter as the first parameter, e.g., {{#babel: nocat=1 | babelcode1 | babelcode2 | ... }}
.
Please note that only one of the parameters above is allowed.
At the moment, it is not possible to use both parameters; for example, {{#babel: nocat=1 | plain=1 | babelcode1 | babelcode2 | ... }}
will not work.
Categorization
If categorization is enabled, the extension creates categories using the Babel AutoCreate bot with the text specified in MediaWiki:babel-autocreate-text-levels and MediaWiki:babel-autocreate-text-main. With basic settings, the categories that the bot creates are not categorized, and to fix this, it is recommended to do the following:
- Create a template {{Babel category }} that will generate categories.
- Replacing text on MediaWiki:babel-autocreate-text-levels with
{{Babel category|level=$1|language=$2|ISO=$3}}
- Replacing text on MediaWiki:babel-autocreate-text-main with
{{Babel category|language=$1|ISO=$2}}
This will allow you to categorize categories automatically, and if something happens, you can simultaneously replace the categorization and text in all categories.
Beállítás
Konfigurációs paraméterek
A kiterjesztésnek hat, a LocalSettings.php
fájlban módosítható paramétere van.
$wgBabelLanguageCodesCdb
- (string) the path of the language code database file, the default should suffice.
$wgBabelLanguageNamesCdb
- (string) the path of the language name database file, the default should suffice.
$wgBabelCategoryNames
- (array of string or boolean, indexed by the strings "1", "2", … "5", "N") where each entry is the name of a category for the skill level indicated by its index, possible variable elements are:
%code%
(language code),%wikiname%
(the name of the language in the wiki's content language), and%nativename%
(the name of the language in its language). To disable adding a category for a particular level, set the corresponding value to false.
- Például:
$wgBabelCategoryNames = [
'0' => 'User %code%-0',
'1' => 'User %code%-1',
'2' => 'User %code%-2',
'3' => 'User %code%-3',
'4' => 'User %code%-4',
'5' => 'User %code%-5',
'N' => 'User %code%-N',
];
- will use categories like "Category:User en-0" and "Category:User fr-N". The default is just "Category:Fr-N" and so on.
$wgBabelMainCategory
- (string) Name of the main (non-level) category for each language to which all users of that language are added. Set to false to disable; defaults to format "Category:Fr". It accepts the same format as
$wgBabelCategoryNames
above. Example:$wgBabelMainCategory = 'User %code%';
$wgBabelDefaultLevel
- (string) Default ability level to use when none is specified, should be an index from
$wgBabelCategoryNames
, that is one of the strings "1", "2", … "5", "N". Default is "N". $wgBabelUseUserLanguage
- (boolean) Whether to use the user interface language for the header and footer message. If false (default), it will be in the page content language. This is because using the user interface language may fragment the parser cache.
$wgBabelCategorizeNamespaces
- Array of namespaces to only add automatic categorization to. For example, if
$wgBabelCategorizeNamespaces = [ NS_USER ];
, then Babel will only add categories to pages in the user namespace. The default is null, which means categorizing all namespaces. $wgBabelCategoryOverride
- Whether to allow Babel categories to be overridden on the wiki using MediaWiki:Babel-category-override
$wgBabelAutoCreate
- Whether to auto-create categories.
Rendszerüzenetek
Several customizations can also be made using MediaWiki namespace messages.
- MediaWiki:babel-template "
Template:User $1
" - The format of template names when one is being included.
- MediaWiki:babel-portal "
"
- The format of the link's target from the language code. Set to the empty string to not link the language code.
- MediaWiki:Babel-autocreate-user "
Babel AutoCreate
" - Username to be used for auto-creation of Babel related categories
- MediaWiki:babel-autocreate-text-levels "
Az ebben a kategóriában szereplő szerkesztők $1 szinten beszélik a(z) $2 nyelvet.
" - Text to insert into auto-created categories for different language levels. You have to change this if you want them to be auto-categorized in the main category of the respective language (
$wgBabelMainCategory
). - MediaWiki:babel-autocreate-text-main "
Az ebben a kategóriában szereplő szerkesztők valamilyen szinten beszélik a(z) $1 nyelvet.
" - Text to insert into auto-created categories for non-level categories. You have to change this if you want them to be auto-categorized in a parent category for all languages.
- MediaWiki:babel "
Bábel szerkesztői információk
" - A doboz fejléce Set to
-
to not display a header. - MediaWiki:babel-url "
Project:Bábel
" - A lap, ahol a kiterjesztés leírása megtalálható Set to
-
to display no link in the header. - MediaWiki:Babel-footer "
Szerkesztők nyelvek szerint
" - A doboz lábléce Set to
-
to not display a footer. - MediaWiki:babel-footer-url "
:Category:Bábel – Felhasználók nyelvek szerint
" - A láblécben linkelendő lap
- MediaWiki:Babel-category-override "
$1
" - Overrides any automatically-generated Babel categories. Paraméterek:
$1 = the category that would be generated normally.
$2 = the language code
$3 = the babel level.
Any categories overridden using this method will not be auto-created to reduce the risk of vandalism or mistaken edits to that page.
API
meta=babel (bab)
- This module requires read rights.
- Source: Babel
- License: GPL-2.0-or-later
Get information about what languages the user knows
- babuser
User to get information about
- This parameter is required.
- Type: user, by any of username, IP, Temporary user, IP range and interwiki name (e.g. "prefix>ExampleName")
- Get the Babel information for user Example
- api.php?action=query&meta=babel&babuser=Example [open in sandbox]
Ezt a kiterjesztést egy vagy több Wikimédia-projekt használja. Ez valószínűleg azt jelenti, hogy stabil és nagy biztonsággal használható ilyen forgalmas oldalakon is. A kiterjesztést használó wikik pontos listáját a Wikimédia CommonSettings.php és InitialiseSettings.php konfigurációs fájljaiban a nevére keresve találhatod meg. Egy adott wikin telepített összes kiterjesztés listája a wiki Special:Version oldalán található. |
This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |