← Back to branch summary

~ubuntu-branches/ubuntu/natty/moin/natty-updates

« back to all changes in this revision

Viewing changes to wiki/underlay/pages/HelpOnMoinCommand(2f)ExportDump/revisions/00000001

  • Committer: Bazaar Package Importer
  • Author(s): Jonas Smedegaard
  • Date: 2008-06-22 21:17:13 UTC
  • mto: This revision was merged to the branch mainline in revision 18.
  • Revision ID: james.westby@ubuntu.com-20080622211713-inlv5k4eifxckelr
Import upstream version 1.7.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
wiki/underlay/pages/HelpOnMoinCommand(2f)ExportDump/revisions/00000001
 
1
## Please edit system and help pages ONLY in the master wiki!
 
2
## For more information, please see MoinMoin:MoinDev/Translation.
 
3
##master-page:Unknown-Page
 
4
##master-date:Unknown-Date
 
5
#acl -All:write Default
 
6
#format wiki
 
7
#language en
 
8
= Creating a HTML dump of wiki content =
 
9
"moin export dump" is an HTML export utility to create static HTML dumps of wiki content.
 
10
 
 
11
(!)  You can dump the entire wiki, a single page, or several pages matching a regular expression.  
 
12
 
 
13
== Example ==
 
14
 
 
15
To execute moin export dump, use the command line interface to execute the moin script utility.  The trailing backslash characters indicate line continuation in the example below.  If your OS does not support command line continuation, key the entire command on a single line.
 
16
 
 
17
{{{
 
18
moin --config-dir=/mywiki \
 
19
     --wiki-url=www.myorg.org/mywiki/ \
 
20
     export dump \
 
21
     --page=WikiSandBox \
 
22
     --target-dir=/home/myname/outputdir \
 
23
     --username=MyName
 
24
}}}
 
25
 
 
26
 
 
27
The `--config-dir` parameter is required and must point to the directory containing your wikiconfig.py script.
 
28
 
 
29
The `--wiki-url` parameter is required and must point to the starting URL of your wiki.
 
30
 
 
31
The `export dump` parameters are required and indicate moin.py should execute the dump.py script in the `export` subdirectory.
 
32
 
 
33
The `--page` parameter is optional and will dump pages matching the pagename.  This may be a regex to select multiple matching pages. If omitted, the contents of the entire wiki will be dumped, excluding the underlay pages.
 
34
 
 
35
The `--target-dir` specifies the output directory and is required.
 
36
 
 
37
The `--username` parameter is optional. With the parameter, the output is limited by ACL rules to pages that can be read by the username.  Without the parameter, the output is limited to pages that can be read by ''all''.
 
38
 
 
39
Note the `--page`, `--target-dir`, and `--username` parameters must follow the `export dump` parameters.
 
40
 
 
41
== Output ==
 
42
 
 
43
The output directory will be populated with HTML pages corresponding to each page in your wiki, or as limited by the `--page` option and ACL rules. 
 
44
 
 
45
An `index.html` file will be created with the contents of your Front``Page or the first page selected by the `--page` option.  An `attachments` subdirectory will be created and all page attachments will be copied.  An `error.log` file will be created.
 
46
 
 
47
If the `--page` parameter is not supplied,  the `TitleIndex.html` and `WordIndex.html` pages will be created. 
 
48
 
 
49
== Known limitations ==
 
50
 
 
51
 * No theme support, a very simple hardcoded theme is used.
 
52
   * Hardcoded "theme" has links to `FrontPage`, `TitleIndex`, and `WordIndex` on every page.
 
53
   * None of the above pages are created when only selected pages are dumped.
 
54
 * Icons are not copied from theme `img` directory.
 
55
 * No selection of user language (UI).
 
56
 * `show_section_numbers=1` is not supported.
 
57
 * Hyperlinks on some system pages do not work correctly. 
 
58
   * Attachments hyperlinks and '' show system pages'' on `TitleIndex` and `WordIndex` pages are invalid.