(English, Fran├žais)

Read this help in French. Lire cette aide en fran├žais.

Lionwiki-t2t is a wiki system for the creation and maintenance of websites.

Lionwiki-t2t pages looks the same as normal webpages, but in addition they have an "Edit" link which helps to edit or add new pages on a website, with a lightweight markup language, like for http://www.wikipedia.org.

Based on Lionwiki-t2t, this present system has some ready to use extensions and a simplified syntax.

Presentation (Edit)

The pages on this site are wiki-based pages, which means that pages can be created and edited by multiple authors. To edit a page, click on the "edit" link which exists somewhere on the page (generally at the top or in the footer). Some pages may be protected by a password.

In this wiki, the default password is "demo". It is adviced to modify it after the installation (see below).

When you edit a page, you see the markup which describe the content of the page. The final rendering, with the choosen formatting, will be displayed only after the page is saved.

Lionwiki-t2t and txt2tags are not (Wikipedia:)WYSIWYG - When editing a page, you see the markup text that describes the content of the page. The basic rules for page markup are simple (you will find them below).

Editing rules (syntax) (Edit)

The syntax of this wiki is following the general rules of txt2tags syntax, which you can find here as a reminder. The idea is you should be able to paste here your txt2tags documents without many modifications (explained in the second part of this document).

Complete syntax (Edit)

  • **bold** : bold
  • //italic// : italic
  • __underline__ : underline
  • --strike-- : strike
  • = surrounding your titles / headings (at different levels)
  • - list
  • + numbered list
  • ``code``
  • % comment (after % won't be interpreted)
  • :
  • [link to an external site http://www.site.com] : link to an external site
  • | tableau | cell 2 | cell 3 | : will work in condition there is an even number of |

    table cell 2 cell 3
    table cell 2 cell 3

    table cell 2 cell 3 cell 4
    table cell 2 cell 3 cell 4

  • Visit txt2tags' website to learn more about the syntax, or use the buttons for quick formatting.

Installation (Edit)

Lionwiki is easy to install, no need to setup a sql database: a webserver (Apache, Lighttpd or Nginx) + php will be enough.

Here is what is possible to do:

Synchronize (Edit)

To synchronise your wiki with your mobile devices, install this in addition:

  • (optionnal) install owncloud : http://owncloud.org/
  • (optionnal) share a subfolder containing your lionwiki install into owncloud
  • install foldersync on an android device and synchronise the text files into var/pages/ between your server and your device (tablet, smartphone), using either ssh (recommended) or owncloud.
  • install for example the 920 text editor on android and edit the pages of your website from your mobile device!

Use (Edit)

  • top menu: you can customise your menu by editing the menu.php file in the root. Sorry we couldn't make it editable online. Maybe later.
  • general configuration: see config.php
  • special configurations, regex etc: you can add extra customisation in your wiki by using the config.t2t file
    • you can have a look at sandbox_cyoa and its configuration file cyoa.t2t for an example of a special customisation using this feature.
  • you can edit the whole wiki (including conf files and index.php) by extracting the editor.zip in the root. Beware, it might be a security breach so you'd better at least rename the folder to something not obvious.

Avantages (Edit)

Some advantages:

  • data are stored in plain text, which are human readable and can be edited from an other application (for example a text editor on your smartphone)
  • simple and sober default theme (minimaxing). CSS using responsive design (for smartphone and tablets). You can easily customise colors using less.
  • Another option theme is using bootstrap, so you can use it as a basis for a modern website.

Tips (Edit)

  • if you need to make your image left, right or centered aligned, keep this in mind:
    • for left align, add an extra space (and/or some text) after the image mark
    • for center align, add an extra space (and/or some text) before and after the image mark
    • for right align, add an extra space (and/or some text) before the image mark

  • if you need to work further on the minimaxing design, rename in the template minimaxing.html the call to minimaxing.css to minimaxing.less

  • you can use you own handwriting font, just name it MyManuscript.ttf, put it in the templates/fonts folder (replace the existing one) and change the css/less file so it will be called before the other fonts.

  • You can also use your favorite font, rename if MyFont.ttf and put it in the templates/fonts folder (replace the existing one).

  • On linux or mac os x, it shouldn't be a problem to double-click on a word and only highlight that word, while on windows it would select also the white space after it, so you can't properly add the syntax. So on windows:
    • either single click after the last character of the word and press CTRL + SHIFT + LEFT ARROW
    • or if you're on mozilla firefox, in about:config, just set layout.word_select.eat_space_to_next_word to False.

Known bugs (Edit)

  • if you edit a part of the document, after saving you might need to reload the page if you want to edit a new part, otherwise the edit field will remain blank.
  • regex have problems with some replacements (lionwiki doesn't keep the \ in regex). Instead include a t2t file using includeconf