Differences between revisions 17 and 18
Revision 17 as of 2017-03-03 19:40:21
Size: 5615
Editor: uid
Comment:
Revision 18 as of 2017-03-08 10:12:14
Size: 2449
Editor: crudo
Comment: Split in HackingMoinMoin
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
== Linee guida ==
Line 10: Line 8:
=== Creare una nuova pagina === == Creare una nuova pagina ==
Line 19: Line 17:
=== Scrivere una nuova pagina === == Scrivere una nuova pagina ==
Line 63: Line 61:

== Installazione ==

Si supponga che nginx sia già in esecuzione e che uwsgi sia già installato.
Si suppone inoltre che nginx sia in esecuzione come utente `www`.
Si scarichi la versione 1.9.8 di MoinMoin e la si estragga in una directory a
scelta, in questo esempio `/usr/local/www/unit_moinmoin`.

=== Configurazione di uwsgi ===

Si salvi la configurazione di uwsgi per la wiki, ad esempio in
`/usr/local/etc/uwsgi/unit_moinmoin.ini`.

{{{#!highlight ini
[uwsgi]
socket = /tmp/unit_moinmoin.sock
chmod-socket = 660

chdir = /usr/local/www/unit_moinmoin
wsgi-file = moin.wsgi

master
workers = 2
max-requests = 200
harakiri = 30
die-on-term
}}}

Si avvii il demone con `uwsgi -T --ini /usr/local/etc/uwsgi/unit_moinmoin.ini`.

=== Configurazione di nginx ===

Aggiungere al blocco `server` desiderato la direttiva

{{{
location / {
    uwsgi_pass /tmp/unit_moinmoin.sock;
    include uwsgi_params;
}
}}}

Quindi ricaricare la configurazione come usuale.

=== Configurazione di MoinMoin ===

{{{#!highlight python
    # Wiki identity ----------------------------------------------------

    # Site name, used by default for wiki name-logo [Unicode]
    sitename = u'Unit'

    # Wiki logo. You can use an image, text or both. [Unicode]
    # For no logo or text, use '' - the default is to show the sitename.
    # See also url_prefix setting below!
    logo_string = u'<img src="%s/common/moinmoin.png" alt="MoinMoin Logo">' % url_prefix_static

    # name of entry page / front page [Unicode], choose one of those:

    # a) if most wiki content is in a single language
    #page_front_page = u"MyStartingPage"

    # b) if wiki content is maintained in many languages
    page_front_page = u"FrontPage"

    # The interwiki name used in interwiki links
    #interwikiname = u'UntitledWiki'
    # Show the interwiki name (and link it to page_front_page) in the Theme,
    # nice for farm setups or when your logo does not show the wiki's name.
    #show_interwiki = 1
}}}

''(↓ da rivedere)''
{{{#!highlight python
    # Security ----------------------------------------------------------

    # This is checked by some rather critical and potentially harmful actions,
    # like despam or PackageInstaller action:
    superuser = [u"crudo", ]

    # IMPORTANT: grant yourself admin rights! replace YourName with
    # your user name. See HelpOnAccessControlLists for more help.
    # All acl_rights_xxx options must use unicode [Unicode]
    acl_rights_before = u"crudo:read,write,delete,revert,admin EditorsGroup:read,write,delete,revert All:read"

    # The default (ENABLED) password_checker will keep users from choosing too
    # short or too easy passwords. If you don't like this and your site has
    # rather low security requirements, feel free to DISABLE the checker by:
    #password_checker = None # None means "don't do any password strength checks"

    # Link spam protection for public wikis (Uncomment to enable)
    # Needs a reliable internet connection.
    #from MoinMoin.security.antispam import SecurityPolicy
}}}

Wiki

Consiglio: puoi leggere il codice di altre pagine premendo il tasto Edit o More Actions:Raw Text. ;)

Creare una nuova pagina

Prima di creare una nuova pagina è necessario pensare a che nome attribuirgli. Il nome farà parte dell'indirizzo della pagina e deve essere in formato CamelCase: la prima lettera deve essere maiuscola (le pagine utente possono non seguire questa regola). Se il nome contiene più parole esse devono essere scritte unite, con la prima lettera di ogni parola maiuscola. Trovi informazioni più dettagliate alla pagina WikiName.

Scrivere una nuova pagina

All'inizio della pagina inserisci alcuni metadati sul formato della sintassi e la lingua del documento.

#format wiki
#language it

Quindi scrivi il titolo della pagina, dovrebbe più o meno rispecchiare il nome. Il titolo va indicato con la sintassi = Titolo della pagina = in una riga priva di altro contenuto.

Le sezioni della pagina assumono una forma gerarchica in base al numero di =. Una sezione di primo livello si indicherà con == Sezione 1 ==, una di secondo con === Sezione 1.1 ===, e via discorrendo. Trovi qui maggiori informazioni.

Dividi il tuo testo in paragrafi che concludano un concetto. Separa ogni paragrafo con una riga vuota. Inserisci inoltre una riga vuota prima e dopo aver definito una sezione.

Per favore, scrivi la pagina in locale usando un editor degno di questo nome e imposta a 80 caratteri il limite della riga. Sono ammesse eccezioni (URL, tabelle).

Puoi scrivere in corsivo inserendo il testo tra una coppia di '' o in grassetto usando '''. Trovi qui maggiori informazioni.

Puoi linkare una pagina interna con la sintassi [[NomeDellaPagina]] oppure con testo del link che sarà mostrato.

Puoi linkare una pagina esterna cona la stessa sintassi, inserendo un URL valido al posto del WikiName. Se inserisci un link esterno considera di aggiungere l'opzione per aprirlo in una nuova scheda del browser. Esempio: [[http://www.macaomilano.org|MACAO|target="_blank"]]. Trovi qui maggiori informazioni.

Per tutto il resto ti invito a leggere la guida ufficiale alla sintassi e la guida completa di MoinMoin :D

WikiGuideLines (last edited 2017-09-15 09:35:52 by crudo)