proga:LMW - Lojbanic MediaWiki

From Lojban
Revision as of 07:38, 23 August 2014 by Gleki (talk | contribs)
Jump to navigation Jump to search

This web site is called Lojbanic MediaWiki (LMW). It integrates

  • a wiki and thus can be edited by you, the user
  • a web forum system
  • quizzes
  • audio/video hosting
  • FAQs

LMW is being developed by the Lojban community. Right now there are 2,040 articles in LMW. As of now LMW is running on Mediawiki 1.35.4.

How to contribute

The wiki uses the same engine as Wikipedia called MediaWiki. So if you have technical problems with improving this wiki you can search for the necessary information applied to Wikipedia or MediaWiki.

If you want to contribute the basic recommendations are:

  1. fix formatting of any broken page you find, add necessary hyperlinks, if the page is too hard to understand add {{jbocre/en}} in the beginning of the code on each of such pages.
  2. Create new pages, add hyperlinks to other pages on the wiki in them, and add hyperlinks in other pages to your page.
  3. Feel freedom. The wiki is made for you too, not for just one person.

Basic Wiki Editing

To edit a Wiki page, you first need to register (use the link in the upper right corner), then after your account is approved you need to log in.

You should then see a tab that says "Edit", in the upper toolbar. Click that to enter the editing interface.

You should be able to mostly just type whatever you want, but if you want to do anything complicated, either open this Mediawiki help guide. Note that paragraphs are separated by two blank lines, so you can hit return once anywhere you like.

To create a new page, just link to it from another page.

If you are creating or editing a page please consider the following conventions:

  • Lojbanic text has bold text reserved for it. .i dei lojbo jufra
  • Translation to other languages have italic text reserved for them. This is an English sentence.
  • Glossing text (showing its structure) is done by text wrapped in <code>...</code> tags. This -is-an-example-of a text-structure.
  • Words are emphasized by underlining them.
  • You can receive e-mail notification on any wiki page change by placing the page to your watchlist by checking the Star (star.svg) button.
  • Discussions related to pages are in "Discussion" tab in the toolbar
  • Pages must not contain the symbol ")" (right bracket).
  • You can see last n pages changed and also pages changed in last n days
    • You can see a link to a difference chart of what was changed in the page. You can also use "History" tab for that

Other trivia

If you are seeking admin help, try the Lojban IRC channel.

Prefixes to pages

Pages can start with a prefix:

  • proga (like this very page) is for stuff related to technical issues of this wiki
  • jboske and BPFK are for pages related to BPFK work

ToDo

This section is supposed to act as a central point in coordinating what needs to be done on the wiki. This is a list of things that still needs to be added to the new MediaWiki. Please add anything you feel is missing or needs fixing. If you feel like adopting something, just write your name behind it in parentheses, maybe together with the current date. When you're finished, delete it, or move it to a Done section below.

  • fix software section
  • Replace the old Tiki (http://www.lojban.org/tiki/) while retaining all the stuff. As of August 2013 this goal is complete. The two wikis are slowly drifting apart since April 2013. Otherwise LMW contains all the stuff from the tiki including text and attachments (files). You are welcome to copy new content from the old wiki to this one until the old tiki is frozen making this one official. Since the old wiki is not much active this drifting apart is not a serious problem.
  • Split all the content using pages prefixes.
    • (Without prefixes): main pages. Clean and usable stuff.
    • BPFK: - pages related to developing Lojban by BPFK.
    • - pages with discussing Lojbanic stuff and discussions of how to develop Lojban. Not usable by lo nintadni (i.e. new users).
      • Many of them are imported from the old tiki, those are a subject to move to other categories or deleted if they are of no use.
    • Stub: - pages to be developed and moved to the first category.
  • Fix all links on jbobau selci'a page. At least one copy of each text must be inside the wiki in mediawiki format (you may still post additional links to texts in other formats). No need in localizing this page to other languages.
  • Check if the links that lead from the main page always end in well-formatted pages without missing hyperlinks.
  • News block is almost absent in LMW. Look at those fance welcome pages at en.wikipedia.org or nds-nl.wikipedia.org We need something like that.
  • When a new version of VisualEditor is out please update it in LMW after finishing #1.
  • Flow extension, a replacement of Talk tabs should be available in beta version in 2014. Please install it when it's ready to use.
  • Clicking on the flags on the welcome screen should change the interface (e.g. the left sidebar) accordingly but currently it's not possible (&setlang flag doesn't work). Wait until the bug is fixed.
  • Currently not possible to edit the code of pages in "User" namespace. Not sure what can be the reason. Visual Editor works on them, though.
  • check whether old and outdated translations exist
  • nicer layout, for the front page, toolbars.
  • the news section is not very good advertisement imo. when i read it as a newbie, with one 10sec clip released in 2007, and two news in 2008, i think the community is almost dead. so, maybe add some news?
    • la selkik:
    • The problem is that there is LOTS of new news. There's plenty of news. I don't see any reason to rewrite that ancient text with some recent news and leave it on the front page though. It's weird. It's as if by adding some particular thing that happened I'm sanctioning the erroneous impression it gives that hardly anything ever happens in jbogu'e. So I say we just archive that news to an article called "News That Used To Be Up On The Main Page For Ages Even Though After A Little While It Wasn't News And Started To Give The Wrong Impression" (except shorter, probably) and forget about it. Who's in?
  • Write up a page for Crash Course, L4B, similar to What Is Lojban?, The Book or The Complete Lojban Language
  • The Contribute page needs expanding. Preferably showing the various ways one can contribute to the Lojban collective e.g. via Jbovlaste, the mw.lojban.org Wiki, jbo.wikipedia.org, jboselkei, tatoeba.org etc.
  • Port the whole of CLL to the wiki
  • Maybe produce an online version of Lojban for Beginners

Missing Extensions

  • The Babel extension may be of interest (http://www.mediawiki.org/wiki/Extension:Babel). Here is an example of use: http://meta.wikimedia.org/wiki/User_language
  • AWC Extension for LMW. It has been discovered that AWC extension no longer works for MW 1.22 wmf11. So la gleki patched it by replacing all deprecated functions with new ones or commenting out some strings that had deprecated functions. The patched extension can be downloaded here. If a file is patched it is backuped in the same folder with suffix @@@. For now uploading user avatars from AWC itself doesn't work. Use [[File: ...]] links or urls instead.

Stylistic Matters:

  • Auto-capitalization is removed from this wiki. "Fanva" and "Ralju Ckupau" don't look like correct Lojban.

Done

Non-Features

There are a couple of things that people want that haven't been implemented yet.

You are more than welcome to add stuff here. If you do so, however, you should probably leave a question in the shoutbox.

  • rlpowell:
    It would be nice if people monitoring a page were sent copies when someone was discussing it.
  • Automatically report broken links
  • Some sort of automatic translation from Lojban, for example button 'link all words to dictionary entries'
  • One should have possibility to change names of users. Then, clicking on username could lead directly to his user page, where standard information (email/country) can be inserted.
  • ilya:
    Maybe search should get you right to the page if there is only one found.

How to add the interface for a new language

Managing LMW. What extensions to patch

If you are in charge of LMW you should do the following:

  1. Open LMW once in a while to see if there are new requests from users for being registered. ConfirmAccount extension might be installed requiring every new user to fill in a short bio about them. So you have to manually let users in. Don't disable this feature otherwise spambots or vandals might come in. Don't use captcha as it has been cracked by vicarious.com.
  2. Update LMW once in a while by running in the root of LMW folder
    cd extensions
    and then:
    cd .. ; git checkout master ; git pull ; cd extensions
    and
    php ../maintenance/update.php
    to update all mysql tables.
    In case of fresh install run
    cd .. ; git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git ; cd extensions
    and then
    chgrp -R apache /home/gleki/public_html/mediawiki-1.19.2/ ; chmod -R g+rwX /home/gleki/public_html/mediawiki-1.19.2/
    replacing the paths acording to where you are moving LMW to.

Update extensions

once in a while. Ensure you are in /extensions folder of the root of your MediaWiki deployment directory.

Note that some of extensions require manual patches.

for ext in Babel cldr CleanChanges LocalisationUpdate Translate UniversalLanguageSelector
 do
   if [ ! -d "$ext" ]
   then
     git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/$ext.git
   fi
   cd $ext; git fetch --tags; git checkout 2014.07; cd ..
 done
cd VisualEditor
git pull
git submodule update --init
cd ..

Scribunto

For it to work you might need to run

chmod a+x /home/gleki/public_html/mediawiki-1.19.2/extensions/Scribunto/engines/LuaStandalone/binaries/*/lua

chcon -t httpd_user_script_exec_t /home/gleki/public_html/mediawiki-1.19.2/extensions/Scribunto/engines/LuaStandalone/binaries/*/lua

Wikiforum

Update only to version 1.22. Later versions have bugs.

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/WikiForum.git -b REL1_22

also needs the following patch:

vim WikiForum/WikiForum.php

Then comment out the following line:

//$wgHooks['SkinTemplateToolboxEnd'][] = 'WikiForumHooks::addNavigationLinkToToolbox';

SimpleTable

As of Mediawiki 1.24alpha only SimpleTable version 1.2a (not later!) works.

http://www.mediawiki.org/wiki/Extension:SimpleTable

SocialProfile

If a user SomeName doesn't exist and when I create a page User:SomeName I can't edit it's code when SocialProfile is enabled. VisualEditor works okay, though.

But what you should do after each update of this extension is to comment out lines 95-97 of SocialProfile/UserProfile/UserProfile.php. After that, you should be able to edit the namespace like normal, and still have the ability for user profiles to appear on the user page.

UniversalLanguageSelector

You should apply this patch to ULS extension until it is included into the MediaWiki core. https://gerrit.wikimedia.org/r/#/c/120475/

If not done users after being registered and logged in will fall back to Lojban interface of LMW which is confusing.

Just run

cd .. ; git fetch https://gerrit.wikimedia.org/r/mediawiki/core refs/changes/75/120475/5 && git checkout FETCH_HEAD ; cd extensions

ConfirmAccount (currently not used in LMW)

Since the author hasn't updated the extension yet we have to use the following patch in extensions/ConfirmAccount/business/AccountRequestSubmission.php:

# Check if biography is long enough
$bioWordCount = preg_match_all("/\\p{L}[\\p{L}\\p{Mn}\\p{Pd}'\\x{2019}]*/u", $this->bio, $matches);
if ($bioWordCount < $wgAccountRequestMinWords) {

Discussions of how to develop Lojban wikis