~funderscoreblog cgit wikiget in touch

moin

Il comando moin viene installato quando si usa setup.py. Se invocandolo dalla shell il comando non viene trovato, è possibile personalizzare e usare wiki/server/moin. Consultare quello script, sono presenti alcuni percorsi da configurare.

Per esempio, se si dispone di un solo wiki o di una wiki farm sulla propria macchina, e se si configura sys.path nel comando moin, non è necessario fornire l'opzione --config-dur=... ogni volta.

È anche possibile impostare le registrazioni se quelle integrate non sono di proprio gradimento.

usage: moin [command] [general options] command subcommand [specific options]

options:
  --version           show program's version number and exit
  -h, --help          show this help message and exit
  -q, --quiet         Be quiet (no informational messages)
  --show-timing       Show timing values [default: False]
  --config-dir=DIR    Path to the directory containing the wiki configuration
                      files. [default: current directory]
  --wiki-url=WIKIURL  URL of a single wiki to migrate e.g. localhost/mywiki/
                      [default: CLI]
  --page=PAGE         wiki page name [default: all pages]



moin ... account check ...
moin ... account create ...
moin ... account disable ...

moin ... cli show ...

moin ... export dump ...
moin ... export package ...

moin ... import irclog ...

moin ... index build ...

moin ... maint cleancache ...
moin ... maint cleanpage ...
moin ... maint globaledit ...
moin ... maint mailtranslators
moin ... maint makecache ...
moin ... maint mkpagepacks ...
moin ... maint reducewiki ...
moin ... maint mailtranslators

moin ... migration data ...

moin ... xmlrpc mailimport ...
moin ... xmlrpc remote ...

General options:
    Most commands need some general parameters before command subcommand:
    --config-dir=/config/directory
        Mandatory for most commands and specifies the directory that contains
        your wikiconfig.py (or farmconfig.py).

    --wiki-url=wiki.example.org/
        Mandatory for most commands and specifies the url of the wiki you like
        to operate on.

Specific options:
    Most commands need additional parameters after command subcommand.

    Sorry, but there is not much docs about that stuff yet, you can check
    docs/CHANGES and the MoinMoin wiki site for more infos (or just try to
    invoke some command/subcommand to see if it emits more help).
    The code you invoke is contained in MoinMoin/script/command/subcommand.py,
    so just reading the comments / source there might help you, too.

Esempio per un'istanza predefinita

moin --config-dir=/usr/share/moin/mywiki  --wiki-url=http://webserver/mywiki migration data 

moin ... account check ...

  --usersunique       Makes user names unique (by appending the ID to name and
                      email, disabling subscribed pages and disabling all, but
                      the latest saved user account); default is to SHOW what
                      will be happening, you need to give the --save option to
                      really do it.
  --emailsunique      Makes user emails unique; default is to show, use --save
                      to save it.
  --wikinames         Convert user account names to wikinames (camel-case).
  --lastsaved         Normally the account most recently USED will survive and
                      the others will be disabled. Using --lastsaved, the
                      account most recently SAVED will survive.
  --save              If specified as LAST option, will allow the other
                      options to save user accounts back to disk. If not
                      specified, no settings will be changed permanently.
  --removepasswords   Remove pre-1.1 cleartext passwords from accounts.

moin ... account create ...

  --name=NAME          Set the wiki user name to NAME.
  --alias=ALIAS        Set the wiki user alias name to ALIAS (e.g. the real
                       name if NAME is cryptic).
  --email=EMAIL        Set the user's email address to EMAIL.
  --password=PASSWORD  Set the user's password to PASSWORD.

moin ... account disable ...

  --uid=UID           Disable the user with user id UID.
  --name=NAME         Disable the user with user name NAME.

moin ... account resetpw ...

  --uid=UID           Reset the password of the user with user id UID to the given password
  --name=NAME         Reset the password of the user with user name to the given password

moin ... cli show ...

moin ... export dump ...

  --target-dir=/your/output/path to specify the directory we write the html files to
  --username=name of the user to perform the dump with

Maggiori informazioni per eseguire il dump del wiki sono presenti alla pagina AiutoSuComandiMoin/DumpDiEsportazione.

moin ... export package ...

  -p PAGES, --pages=PAGES
                        Comma seperated list of pages to package.
  -o OUTPUT, --output=OUTPUT
                        Output file for the package.
  -s SEARCH, --search=SEARCH
                        Search string to match.
  -u PACKAGE_USER, --user=PACKAGE_USER
                        User as whom the package operation will be performed
                        as.

Per pacchettizzare tutte le pagine create dagli utenti, non specificare --pages o --search.

moin ... import irclog ...

forse è necessaria una directory con file IRC

moin ... index build ...

viene usato per creare l'indice di Xapian, va' in crash se Xapian non è installato

moin ... maint cleancache ...

rimuove i file nella cache

moin ... maint cleanpage ...

crea uno script shell Linux che può essere usato (dopo averlo controllato) per ripulire la data_dir.

Cerca di classificare le directory della pagina in classi e sposta le pagina dalla posizione normale in 2 directory "trash" e "deleted" (è necessario crearle!)

moin ... maint globaledit ...

Questo comando utilizzato essenzialmente in fase di sviluppo, è per la modifica globale delle pagine di un wiki (viene usato per semplificare ACL e metadati sul master wiki). Se si desidera farne uso, perfavore consultare prima di tutto il codice sorgente.

moin ... maint mailtranslators ...

Usato solo in fase di sviluppo (invia mail ai traduttori per avvisarli di un nuovo rilascio).

moin ... maint makecache ...

crea file cache in base al registro degli eventi e ai collegamenti.

moin ... maint mkpagepacks ...

NON USARE MAI QUESTO COMANDO IN UN WIKI REALE! Questo va utilizzato su un wiki locale di prova.

moin ... maint reducewiki ...

moin --config-dir=/usr/share/moin/mywiki  --wiki-url=localhost/mywiki  maint reducewiki --target-dir=/tmp/target

moin ... migration data ...

sposta i dati delle pagine verso una nuova versione:

moin --config-dir=/usr/share/moin/mywiki  --wiki-url=http://wikiserver/mywiki migration data 

moin ... server standalone ...

Avvia il server standalone (e offre più opzioni di ./wikiserver.py).

# Per maggiori informazioni:
moin server standalone --help

moin ... xmlrpc mailimport ...

per esempio:

# Questo è il file di configurazione per il client di acquisizione mail

# Questa parola segreta deve essere nota al server wiki
mail_import_secret = u"foo"

# URL del wiki designato
mail_import_url = u"http://localhost/?action=xmlrpc2"

moin ... xmlrpc remote ...

è necessario un file remotescriptconf.py