Documentation update.

git-svn-id: svn://pmwiki.org/pmwiki/trunk@2734 524c5546-5005-0410-9a3e-e25e191bd360

1 files changed, 6 insertions, 8 deletions

diff --git a/wikilib.d/PmWiki.UTF-8 b/wikilib.d/PmWiki.UTF-8
index dd83b77f..6537bdc0 100644
--- a/wikilib.d/PmWiki.UTF-8
+++ b/wikilib.d/PmWiki.UTF-8
@@ -1,11 +1,9 @@
-version=pmwiki-2.2.30 ordered=1 urlencoded=1
-agent=Mozilla/5.0 (X11; Linux x86_64; rv:5.0) Gecko/20100101 Firefox/5.0
+version=pmwiki-2.2.34 ordered=1 urlencoded=1
 author=Petko
 charset=UTF-8
-csum=+encoding of the filenames, convmv
-host=85.171.160.186
+csum=
 name=PmWiki.UTF-8
-rev=16
-targets=Cookbook.ISO8859MakePageNamePatterns,Cookbook.UTF-8
-text=!!!Enabling UTF-8 Unicode language encoding in your page header. %0a%0aUTF-8 allows for support of various languages, including Asian languages and their character depth.  It is a widely supported and flexible character encoding, used for many European languages and can also represent Chinese, Japanese and Korean. %0a%0aIt's fairly simple to enable UTF-8 on your wiki pages.  Currently PmWiki 2.0 versions have the UTF-8 file needed already loaded. %0a%0a!!!!Here are the steps to enable UTF-8 %0a%0a*Open your config.php file%0a*Add this line:[[%3c%3c]]'''include_once($FarmD.'/scripts/xlpage-utf-8.php');'''%0a*Save and upload your config.php file back to the server.%0a*Convert existing page files containing international characters to UTF-8. You need to change the encoding string ''and'' the character encoding, ''and'' the encoding of the filenames, if they contain non-Latin characters.%0a%0a'sed', 'recode', and 'convmv' can help to convert existing page files, e.g.%0a sed -i s/^charset=ISO-8859-1/charset=UTF-8/%0a recode ISO-8859-1..UTF-8%0a convmv --help%0a%0aIf you validate your site you should see that UTF-8 is default encoding.%0a%0a'' '''NOTE: ''' The encoding type used when [@config.php@] is saved has an effect if you will be converting between character encodings on your wiki. Refer to [[Cookbook:ISO8859MakePageNamePatterns#page-encoding | page encoding]] for more details. If you are not using international characters then you do not need to be concerned about this.''%0a%0aSee also [[Cookbook:UTF-8]] for tips.%0a
-time=1315670897
+rev=21
+targets=PmWiki.Internationalizations,PmWiki.Upgrades,PmWiki.LocalCustomizations,Cookbook.UTF-8
+text=Summary: Enabling UTF-8 Unicode language encoding in your wiki. %0a%0aUTF-8 supports all languages and alphabets, including Asian languages and their character depth.  It is a widely supported and flexible character encoding, used for many European languages and can also represent Chinese, Japanese and Korean. %0a%0aIt's fairly simple to enable UTF-8 on your wiki pages. Current PmWiki versions have the UTF-8 file which needs to be enabled.%0a%0a!! Enabling UTF-8 on a new wiki%0a%0aIf you start a new wiki in any language with the latest PmWiki version, it is highly recommended to enable UTF-8. In the future, PmWiki will change to use the UTF-8 encoding by default, so if you already use it, you will not need a complex "migration" to UTF-8 later.%0a%0aTo enable UTF-8 for a new wiki, add this line near the beginning of config.php:%0a%0a  include_once("scripts/xlpage-utf-8.php");%0a%0aThis line should come ''before'' a call to the XLPage() function in [[internationalizations|international wikis]].%0a%0a!! Enabling UTF-8 on existing wikis%0a%0aCurrently, this is possible ''only if your group and page ''names'' don't contain international characters''. The names of wiki pages are used as file names, and we don't have yet an easy way to rename the disk files.%0a%0aIf your wiki doesn't have international page names, first [[upgrade(s)]] to the latest PmWiki version. To enable UTF-8, add these lines near the beginning of config.php:%0a%0a  include_once("scripts/xlpage-utf-8.php");%0a  $DefaultPageCharset = array(''=>'ISO-8859-1'); # see below%0a%0aThese lines should come ''before'' a call to the XLPage() function in [[internationalizations|international wikis]].%0a%0aThe $DefaultPageCharset line is there to fix and correctly handle some pages with missing or wrong attributes, created by older PmWiki versions.%0a%0a* Most wikis in European languages are likely to be in the ISO-8859-1 encoding and should use:\\%0a  @@$DefaultPageCharset = array(''=>'ISO-8859-1');@@%0a* Wikis in Czech and Hungarian language are likely to be in the ISO-8859-2 encoding, they should use this line instead:\\%0a  @@ $DefaultPageCharset = array(''=>'ISO-8859-2', 'ISO-8859-1'=>'ISO-8859-2'); @@%0a* Wikis in Turkish language are likely to be in the ISO-8859-9 encoding, they should use this line instead:\\%0a  @@ $DefaultPageCharset = array(''=>'ISO-8859-9', 'ISO-8859-1'=>'ISO-8859-9'); @@%0a%0a%0aYou should also delete the file @@ wiki.d/.pageindex@@. This file contains a cache of links and words from your pages and is used for searches and pagelists. PmWiki will rebuild it automatically with the new encoding.%0a%0a!! Notes%0a* You need to save your config.php file in the UTF-8 encoding, and "Without Byte Order Mask (BOM)". See [[LocalCustomizations#encoding|Character encoding of config.php]].%0a* See also [[Cookbook:UTF-8]] for tips.%0a
+time=1320749219