Mercurial > public > src > moin > 1.9
diff docs/UPDATE.html @ 3888:a016745f4cca
make install-docs interwiki
author | Thomas Waldmann <tw AT waldmann-edv DOT de> |
---|---|
date | Sun, 20 Jul 2008 14:14:01 +0200 |
parents | 8ffe79f29100 |
children | a1f682e8f8f8 |
line wrap: on
line diff
--- a/docs/UPDATE.html Sun Jul 20 14:01:05 2008 +0200 +++ b/docs/UPDATE.html Sun Jul 20 14:14:01 2008 +0200 @@ -19,6 +19,7 @@ + <link rel="Start" href="http://master17.moinmo.in/FrontPage"> <link rel="Alternate" title="Wiki Markup" href="http://master17.moinmo.in/HelpOnUpdating?action=raw"> <link rel="Alternate" media="print" title="Print View" href="http://master17.moinmo.in/HelpOnUpdating?action=print"> @@ -35,7 +36,7 @@ <li><a class="backlink" href="http://master17.moinmo.in/4ct10n/fullsearch/HelpOnUpdating?action=fullsearch&context=180&value=linkto%3A%22HelpOnUpdating%22" rel="nofollow" title="Click to do a full-text search for this title">HelpOnUpdating</a></li> </ul> <div dir="ltr" id="content" lang="en"><span class="anchor" id="top"></span> -<span class="anchor" id="line-8"></span><p class="line867"><a href="http://master17.moinmo.in/HelpContents">HelpContents</a> > <a href="http://master17.moinmo.in/HelpOnAdministration">HelpOnAdministration</a> > HelpOnUpdating <span class="anchor" id="line-9"></span><span class="anchor" id="line-10"></span><p class="line867"><strong>Index</strong> <span class="anchor" id="line-11"></span><div class="table-of-contents"><p class="table-of-contents-heading">Contents<ol><li><ol><li> +<span class="anchor" id="line-8"></span><p class="line867"><a href="http://master17.moinmo.in/HelpContents">HelpContents</a> > <a href="http://master17.moinmo.in/HelpOnAdministration">HelpOnAdministration</a> > HelpOnUpdating <span class="anchor" id="line-9"></span><span class="anchor" id="line-10"></span><p class="line867"><strong>Index</strong> <span class="anchor" id="line-11"></span><div class="table-of-contents"><p class="table-of-contents-heading">Contents<ol><li> <a href="#Generalprocedures">General procedures</a><ol><li> <a href="#DownloadandunpackthenewMoinMoinarchive">Download and unpack the new MoinMoin archive</a></li><li> <a href="#Readingthedocs">Reading the docs</a></li><li> @@ -45,7 +46,9 @@ <a href="#Staticstuffupdate">Static stuff update</a></li><li> <a href="#Wikipagesupdate">Wiki pages update</a><ol><li> <a href="#SystemandHelppages">System and Help pages</a></li><li> +<a href="#InterWikidata">InterWiki data</a></li><li> <a href="#Yourvaluableownpages">Your valuable own pages</a></li></ol></li><li> +<a href="#Cleanyourcache">Clean your cache</a></li><li> <a href="#Troubleshooting">Troubleshooting</a></li></ol></li></ol></li></ol></div><p class="line874"> <span class="anchor" id="line-12"></span><span class="anchor" id="line-13"></span><p class="line867"> <h2 id="Generalprocedures">General procedures</h2> <span class="anchor" id="line-14"></span><p class="line867"> @@ -65,10 +68,14 @@ <span class="anchor" id="line-66"></span><p class="line867"> <h4 id="SystemandHelppages">System and Help pages</h4> <span class="anchor" id="line-67"></span><p class="line862">System and help pages are separately stored in the <tt class="backtick">underlay</tt> directory. Just use the fresh underlay directory we provide in the distribution archive (move the old one to your backup directory). <span class="anchor" id="line-68"></span><span class="anchor" id="line-69"></span><p class="line867"> +<h4 id="InterWikidata">InterWiki data</h4> +<span class="anchor" id="line-70"></span><p class="line862">Copy <tt class="backtick">intermap.txt</tt> from the distribution archive into your wiki data <span class="anchor" id="line-71"></span><span class="anchor" id="line-72"></span><p class="line867"> <h4 id="Yourvaluableownpages">Your valuable own pages</h4> -<span class="anchor" id="line-70"></span><p class="line862">See CHANGES and README.migration for maybe necessary steps to convert your <tt class="backtick">data_dir</tt> to what we expect. <span class="anchor" id="line-71"></span><span class="anchor" id="line-72"></span><p class="line867"> +<span class="anchor" id="line-73"></span><p class="line862">See CHANGES and README.migration for maybe necessary steps to convert your <tt class="backtick">data_dir</tt> to what we expect. <span class="anchor" id="line-74"></span><span class="anchor" id="line-75"></span><p class="line867"> +<h3 id="Cleanyourcache">Clean your cache</h3> +<span class="anchor" id="line-76"></span><p class="line862">Finally, delete cached data by running <tt class="backtick">moin ... maint cleancache</tt>. This is necessary for things like the updated <a href="http://master17.moinmo.in/InterWiki">InterWiki</a> data to trickle down into the pages that use it. <span class="anchor" id="line-77"></span><span class="anchor" id="line-78"></span><p class="line867"> <h3 id="Troubleshooting">Troubleshooting</h3> -<span class="anchor" id="line-73"></span><p class="line874">Use absolute pathes, not relative ones. <span class="anchor" id="line-74"></span><span class="anchor" id="line-75"></span><p class="line874">Make sure you have an adequate logging configuration (see server adaptor script and the logging configuration file) and carefully read the log! <span class="anchor" id="line-76"></span><span class="anchor" id="line-77"></span><p class="line862">Make sure python can find the MoinMoin code package and your wiki configuration files (fix <tt class="backtick">sys.path</tt> in the server adaptor script or PYTHONPATH in the environment). <span class="anchor" id="line-78"></span><span class="anchor" id="line-79"></span><p class="line862">Make sure MoinMoin can find the data_dir and data_underlay_dir (see <tt class="backtick">wikiconfig.py</tt>). <span class="anchor" id="line-80"></span><span class="anchor" id="line-81"></span><p class="line862">When you are editing python code files (e.g. <tt class="backtick">wikiconfig.py</tt>), be careful to indent correctly (use 4 spaces, not tabs) and also be careful not to make syntax errors. If you have a working config, do not make too many changes at once (and have a backup of a working version). <span class="anchor" id="line-82"></span><span class="anchor" id="line-83"></span><p class="line862">Check permissions (the moin process needs read/write access to <tt class="backtick">data_dir</tt> and <tt class="backtick">data_underlay_dir</tt>, it needs at least read access to the <a href="http://master17.moinmo.in/MoinMoin">MoinMoin</a> code and configuration). <span class="anchor" id="line-84"></span><span class="anchor" id="line-85"></span><p class="line862">Depending on your installation, more tightly secured permissions are a good idea. Ideally, you assign all files in the data directory to the user the web server runs under, and then you use <tt class="backtick">700</tt> or <tt class="backtick">770</tt> - see also the <tt class="backtick">config.umask</tt> setting. <span class="anchor" id="line-86"></span><span class="anchor" id="bottom"></span></div><p id="pageinfo" class="info" lang="en" dir="ltr">MoinMaster: HelpOnUpdating (last edited 2008-06-08 14:27:43 by <span title="??? @ localhost[127.0.0.1]">localhost</span>)</p> +<span class="anchor" id="line-79"></span><p class="line874">Use absolute pathes, not relative ones. <span class="anchor" id="line-80"></span><span class="anchor" id="line-81"></span><p class="line874">Make sure you have an adequate logging configuration (see server adaptor script and the logging configuration file) and carefully read the log! <span class="anchor" id="line-82"></span><span class="anchor" id="line-83"></span><p class="line862">Make sure python can find the MoinMoin code package and your wiki configuration files (fix <tt class="backtick">sys.path</tt> in the server adaptor script or PYTHONPATH in the environment). <span class="anchor" id="line-84"></span><span class="anchor" id="line-85"></span><p class="line862">Make sure MoinMoin can find the data_dir and data_underlay_dir (see <tt class="backtick">wikiconfig.py</tt>). <span class="anchor" id="line-86"></span><span class="anchor" id="line-87"></span><p class="line862">When you are editing python code files (e.g. <tt class="backtick">wikiconfig.py</tt>), be careful to indent correctly (use 4 spaces, not tabs) and also be careful not to make syntax errors. If you have a working config, do not make too many changes at once (and have a backup of a working version). <span class="anchor" id="line-88"></span><span class="anchor" id="line-89"></span><p class="line862">Check permissions (the moin process needs read/write access to <tt class="backtick">data_dir</tt> and <tt class="backtick">data_underlay_dir</tt>, it needs at least read access to the <a href="http://master17.moinmo.in/MoinMoin">MoinMoin</a> code and configuration). <span class="anchor" id="line-90"></span><span class="anchor" id="line-91"></span><p class="line862">Depending on your installation, more tightly secured permissions are a good idea. Ideally, you assign all files in the data directory to the user the web server runs under, and then you use <tt class="backtick">700</tt> or <tt class="backtick">770</tt> - see also the <tt class="backtick">config.umask</tt> setting. <span class="anchor" id="line-92"></span><span class="anchor" id="bottom"></span></div><p id="pageinfo" class="info" lang="en" dir="ltr">MoinMaster: HelpOnUpdating (last edited 2008-07-16 18:34:31 by <span title="SamMorris @ 78.146.165.120[78.146.165.120]"><a class="interwiki" href="http://moinmo.in/SamMorris" title="SamMorris @ 78.146.165.120[78.146.165.120]">SamMorris</a></span>)</p> <div id="pagebottom"></div> </div> </body>