Talk:Www.wikipedia.org template/Documentation

Documentation

Although the portal templates themselves are permanently protected for security reasons, you are welcome to edit the staging ('/temp') portal. A Meta administrator will review your changes and copy-paste the raw (X)HTML5 code into the live portal. If a few days pass without that happening, post a friendly reminder at Talk:Www.wikipedia.org template.

The Wikipedia multilingual portal consists of four main sections: the Top 10 ring of languages surrounding the Wikipedia 'puzzle ball' logo; the search box; the stratified list of language editions; and the sister project links at the bottom. The fundamental principle behind the portal's design is quick access to most of Wikipedia's language editions without favoring one language in particular. (Until 2005, www.wikipedia.org redirected to the English Wikipedia's main page, which seemed a little anglocentric, to say the least.)

Unfortunately, designing a usable portal for choosing among hundreds of languages, while keeping the page relatively small and simple, is a hard problem. (Solutions wanted!) The status quo is to sort the languages by page views in the Top 10 ring and by number of articles on the rest of the page.

Adding a language to the portal edit

In order to keep the portal from growing out of control, the portal is limited to all language editions that meet one of the following conditions:

  1. It contains 100 or more articles, as determined by the {{NUMBEROFARTICLES}} keyword or Special:Statistics. (Look for articles= at http://xx.wikipedia.org/w/api.php?action=query&meta=siteinfo&siprop=statistics, where xx is the wiki's language code.)
  2. Or it is one of the 10 most frequently visited language editions, as listed at Wikipedia Statistics (sort descending by 'Views per hour').

Note that closed wikis may not be listed in the portal.

Once a language edition reaches 100 articles, please add a notice to Wikimedia News and add it to this portal. Search the page for '100+ articles' (or '1,000+' etc.) and add this line to the list that follows:
<a href="//xx.wikipedia.org/" lang="xx">Name</a>&nbsp;
where xx is the wiki's subdomain (typically an ISO 639 code) and Name is the name of the language in that language. Use title case. Place the wiki's listing in alphabetical order by Name.
  • If the wiki is not written in a Latin-based script, the line should look like this:
    <a href="//xx.wikipedia.org/" lang="xx" title="Romanization">Name</a>&nbsp;
    where Romanization is the standard romanization for Name (also in title case). The romanization will appear as the link's tooltip. Place the wiki's listing in alphabetical order by romanization.
  • If the wiki is written from right to left, the line should look like this:
    <a href="//xx.wikipedia.org/" lang="xx" dir="rtl" title="Romanization"><bdi>Name</bdi></a>&nbsp;
  • If the wiki is primarily written with more than one script, the line should look like this:
    <a href="//xx.wikipedia.org/" lang="xx"><span lang="xx-Xxx1">Name 1</span> / <span lang="xx-Xxx2">Name 2</span></a>&nbsp;
    where Xxx1 and Xxx2 are the ISO 15924 codes for the language's scripts (for example, 'Latn' for Latin-based alphabets). Only account for scripts that are actually used on the wiki, so as to avoid teasing visitors with content that does not exist.
    • If the one of the scripts is written from right to left, use a <bdi> tag instead of a <span> tag around the right-to-left text.

Promoting a language edit

The middle portion of the portal has sections for each power-of-ten number of articles. Once a language edition reaches 1,000 articles (or 10,000 or 100,000), its listing should be moved up a level. That's all you have to do in most cases.

Once the language edition reaches 100,000 articles, currently the second-highest level, an extra step is necessary to add it to the search box:

  1. Search the page for 'id="language"' and add this line to the list that follows:
    <option value="xx" lang="xx">Name</option>
    
    Place the line in alphabetical order by Name. This adds the language to the dropdown menu.
    • If the language is not written in a Latin-based script, add the romanization to the end of the line, so we know how to alphabetize it:
      <option value="xx" lang="xx">Name</option><!-- Romanization -->
      
    • Do not use the dir="rtl" attribute or <bdi> tag here.
Return to "Www.wikipedia.org template/Documentation" page.