github/pelican
1
0
Fork 1
mirror of https://github.com/getpelican/pelican.git synced 2025-10-15 20:28:56 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update the translation documentation.

Browse source
This commit is contained in:
Alexis Metaireau 2011-01-06 02:33:14 +01:00
commit 6e4a826dc1
1 changed files with 34 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

36
docs/getting_started.rst
View file

@ -91,7 +91,39 @@ the menu.
Translations
============
It is possible to translate articles. To do so, you need to add a `Lang` meta
It is possible to translate articles. To do so, you need to add a `lang` meta
in your articles/pages, and to set a `DEFAULT_LANG` setting (which is en by
default). Then, only articles with this default language will be listed, and
default).
Then, only articles with this default language will be listed, and
each article will have a translation list.
Pelican uses the "slug" of two articles to compare if they are translations of
each others. So it's possible to define (in restructured text) the slug
directly.
Here is an exemple of two articles (one in english and the other one in
french).
The english one::
Foobar is not dead
##################
:slug: foobar-is-not-dead
:lang: en
That's true, foobar is still alive !
And the french one::
Foobar n'est pas mort !
#######################
:slug: foobar-is-not-dead
:lang: fr
Oui oui, foobar est toujours vivant !
Despite the text quality, you can see that only the slug is the same here.
You're not forced to define the slug that way, and it's completely possible to
have two translations with the same title (which defines the slug)