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&amp;context=180&amp;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> &gt; <a href="http://master17.moinmo.in/HelpOnAdministration">HelpOnAdministration</a> &gt; 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> &gt; <a href="http://master17.moinmo.in/HelpOnAdministration">HelpOnAdministration</a> &gt; 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&nbsp;...&nbsp;maint&nbsp;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>