9b3341f836
* Added Windows hints and v1.2 infos * added some windows batch files * switched from 'cliopts' to 'cli' * "named args" * All arguments passed to php are UTF-8 encoded * removed local path from repository. Use doku.local.php * added/changed support for - small - big - anchordef - definition_list - comment - include and search macros * added #pragma directives as comments to dokuwiki * recreate "_dokuwiki.changes" * Support for non-ascii characters in media files
94 lines
2.7 KiB
Markdown
Executable file
94 lines
2.7 KiB
Markdown
Executable file
Complete MoinMoin to DokuWiki converter
|
|
=======================================
|
|
|
|
Uses native MoinMoin modules to handle converting and translating paths.
|
|
Converts also page history and edit-log.
|
|
|
|
http://www.dokuwiki.org/tips:moinmoin2doku
|
|
|
|
Tested with MoinMoin 1.9.9 and DokuWiki 2018-04-22 releases under Windows 7
|
|
|
|
You need to run this on host where both MoinMoin and DokuWiki are configured,
|
|
it uses current configuration from both wikis.
|
|
|
|
Edit `doku.php` if your DokuWiki installation is other than `/usr/share/dokuwiki`
|
|
|
|
To convert moinmoin all pages with history, invoke:
|
|
```
|
|
$ ./moin2doku.py -a -d /var/lib/dokuwiki
|
|
```
|
|
|
|
To convert single page (FrontPage):
|
|
```
|
|
$ ./moin2doku.py -F moinmoin/data/pages/FrontPage -d out
|
|
```
|
|
|
|
You should invoke `bin/indexer.php` after conversion to make all pages are indexed.
|
|
|
|
and ensure ownership of files is correct:
|
|
(`www-data:www-data` being your uid/gid webserver runs):
|
|
```
|
|
# chown -R www-data:www-data /var/lib/dokuwiki/pages/*
|
|
# chown -R www-data:www-data /var/lib/dokuwiki/media/*
|
|
```
|
|
additionally, depending on your configuration, you may need to gzip the attic pages.
|
|
|
|
|
|
Hints for Windows Users
|
|
-----------------------
|
|
|
|
The Batchfiles (`*.cmd`) should help to do the conversation under Windows. You should
|
|
create a copy of the `settings.cmd` and call it `settings.local.cmd` to set your
|
|
own local paths.
|
|
|
|
Call `moin2doku.cmd` to convert the full MoinMoin Wiki. All DokuWiki pages will be
|
|
written to an `out` folder in the current directory.
|
|
|
|
This will convert a single page:
|
|
```
|
|
D:\moin2doku\> moin2doku.cmd MyMoinPage
|
|
```
|
|
|
|
Set `%OUTDIR%` to an alternativ output folder. This should not be the dokuwiki `data`
|
|
folder if you want to do a full conversation.
|
|
|
|
The `reindex.cmd` will call the `bin/indexer.php`-Skript.
|
|
|
|
|
|
History
|
|
=======
|
|
|
|
version 0.1 (2010-02)
|
|
-------------------
|
|
|
|
Slim Gaillard, based on the "extended python" convert.py script here:
|
|
https://www.dokuwiki.org/tips:moinmoin2doku?rev=1297006559#extended_python
|
|
|
|
version 0.2 (2011)
|
|
----------------
|
|
|
|
Elan Ruusamäe, moved to github, track history there
|
|
https://github.com/glensc/moin2doku
|
|
|
|
version 1.0 (2012)
|
|
----------------
|
|
|
|
Complete moinmoin to dokuwiki converter, uses native moinmoin code to handle
|
|
converting and translating paths. Converts also page history and edit-log.
|
|
|
|
This marks the project "done", I will no longer develop it or support it, as I got my conversion done. However, I do accept patches (pull requests) to sane amount.
|
|
|
|
I put repo online so others have better starting point than I did.
|
|
|
|
|
|
version 1.1 (2015)
|
|
----------------
|
|
Modifed the script to work with newer Moin versions and API changes.
|
|
|
|
|
|
version 1.2 (2019-01)
|
|
----------------
|
|
Some modifications to work with current DokuWiki and added more formattings.
|
|
|
|
Search GitHub Forks for newer versions of this project.
|