6548
Comment:
|
← Revision 27 as of 2017-09-15 09:35:52 ⇥
3366
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
## page was renamed from Infrastructure/Wiki | ## page was renamed from Wiki |
Line 5: | Line 5: |
= Wiki = | = Linee guida: Wiki = |
Line 7: | Line 7: |
== Installazione == | == Basics == Consiglio: puoi leggere il codice di altre pagine premendo il tasto `Edit` o `More Actions:` → `Raw Text`. ;) |
Line 9: | Line 11: |
La wiki è gestita da MoinMoin 1.9.8 in esecuzione su FreeBSD. La seguente documentazione fa riferimento a tale configurazione, ciononostante il setup è facilmente riproducibile. |
=== Creare una nuova pagina === Prima di creare una nuova pagina è necessario pensare che nome attribuirle. 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 devono essere scritte unite, con la prima lettera di ogni parola maiuscola. Trovi informazioni più dettagliate alla pagina [[WikiName]]. |
Line 13: | Line 19: |
Si danno per scontati: * un sistema host già in esecuzione; * un filesystem pronto ad ospitare jail; * una instanza di Nginx all'interno di una jail configurato e in esecuzione. |
=== Scrivere una nuova pagina === All'inizio della pagina inserisci alcuni metadati sul formato della sintassi e la lingua del documento. |
Line 18: | Line 23: |
È consigliato avere uno snapshot aggiornato dell'archivio dei ports prima di procedere. === Installazione della jail === {{{#!highlight bash zfs create antigone/usr/local/jails/unit_moinmoin cd /usr/local/jails/unit_moinmoin fetch -q -o - ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/10.2-RELEASE/base.txz | tar xpf - mkdir -p usr/ports var/ports/packages var/ports/distfiles var/ports/obj echo "nameserver 10.1.1.1" > etc/resolv.conf |
{{{ #format wiki #language it |
Line 31: | Line 28: |
/etc/jail.conf | Quindi scrivi il titolo della pagina, dovrebbe più o meno rispecchiare il nome scelto prima. 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 [[HelpOnMoinWikiSyntax#Headings_and_table_of_contents|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 [[HelpOnFormatting|qui]] maggiori informazioni. Puoi linkare una pagina interna con la sintassi `[[NomeDellaPagina]]` oppure con `[[NomeDellaPagina|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 [[HelpOnLinking|qui]] maggiori informazioni. Per tutto il resto ti invito a leggere la [[HelpOnMoinWikiSyntax|guida ufficiale alla sintassi]] e la [[HelpContents|guida completa di MoinMoin]] :D == Calendario == Per aggiungere un appuntamento nel [[Calendar|calendario]] premi su uno dei giorni disponibili. Ti si presenterà il normale editor con un template già pronto. Il titolo (elemento intestazione di primo livello, delimitato da coppie di `=`) della pagina sarà presente nel tooltip che appare passando col mouse sopra le date impegnate da un appuntamento. Scegli quindi un nome adeguato (generalmente il nome dell'attività). === Redirect === Puoi impostare un redirect da un evento del calendario a una pagina della wiki con la seguente sintassi |
Line 33: | Line 71: |
exec.start = "/bin/sh /etc/rc"; exec.stop = "/bin/sh /etc/rc.shutdown"; exec.clean; |
#redirect ConnessioniCaotiche2017 |
Line 37: | Line 73: |
host.hostname = "$host.oikia.unit.macaomilano.org"; path = "/usr/local/jails/$host"; mount.fstab = "/etc/jail.fstab.d/$host.fstab"; http-proxy { interface = "re0"; ip4.addr = "re0|10.1.1.3/24"; $host = "http-proxy"; allow.mount.devfs; allow.mount.procfs; mount.devfs; mount.procfs; enforce_statfs = 1; } unit_moinmoin { interface = "re0"; ip4.addr = "re0|10.1.1.9/24"; $host = "unit_moinmoin"; allow.mount.devfs; allow.mount.procfs; mount.devfs; mount.procfs; enforce_statfs = 1; } |
= Connessioni Caotiche = |
Line 65: | Line 76: |
/etc/jail.fstab.d/unit_moinmoin.fstab {{{ /usr/ports /usr/local/jails/unit_moinmoin/usr/ports nullfs ro 0 0 }}} |
Nota come sia comunque necessario impostare un titolo nella pagina di redirect. |
Line 70: | Line 78: |
/usr/local/jails/unit_moinmoin/etc/rc.conf {{{#!highlight bash uwsgi_enable="YES" uwsgi_flags="-T --ini /usr/local/etc/uwsgi.ini" }}} /usr/local/jails/unit_moinmoin/etc/make.conf {{{#!highlight makefile CFLAGS = -O2 -pipe MAKE_JOBS_NUMBER = 4 WRKDIRPREFIX= /var/ports/obj DISTDIR= /var/ports/distfiles PACKAGES= /var/ports/packages DEFAULT_VERSIONS=python=2.7 ssl=libressl OPTIONS_UNSET+= DEBUG DOCS EXAMPLES TESTS NLS IPV6 lang_perl5.20_UNSET += PERL_64BITINT }}} /usr/local/jails/unit_moinmoin/etc/periodic.conf {{{ daily_output="/dev/null" daily_status_security_output="/dev/null" weekly_output="/dev/null" monthly_output="/dev/null" }}} === Configurazione del reverse proxy nginx === /usr/local/jails/http-proxy/var/www/robots.txt {{{ User-agent: * Disallow: / }}} /usr/local/jails/http-proxy/usr/local/etc/nginx/sites-available/wiki.unit.macaomilano.org.conf {{{#!highlight nginx server { listen 80; server_name wiki.unit.macaomilano.org; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name wiki.unit.macaomilano.org; access_log /var/log/nginx/wiki.unit.macaomilano.org-access.log; error_log /var/log/nginx/wiki.unit.macaomilano.org-error.log error; ssl on; ssl_protocols TLSv1 TLSv1.1 TLSv1.2; ssl_prefer_server_ciphers on; ssl_ciphers 'EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH'; ssl_session_cache shared:SSL:5m; ssl_session_timeout 5m; ssl_dhparam /path/to/dhparam.pem; ssl_certificate /path/to/unit.macaomilano.org-bundle.pem; ssl_certificate_key /path/to/unit.macaomilano.org.key; location / { uwsgi_pass 10.1.1.9:9000; include uwsgi_params; } location = /robots.txt { alias /var/www/robots.txt; } } }}} {{{#!highlight bash jexec http-proxy "ln -s /usr/local/etc/nginx/sites-available/wiki.unit.macaomilano.org.conf /usr/local/etc/nginx/sites-enabled/ jexec http-proxy service nginx reload }}} === Installazione di moinmoin === {{{#!highlight bash jail -c unit_moinmoin jexec unit_moinmoin tzselect jexec unit_moinmoin csh cd /usr/ports/www/uwsgi make config-recursive make install clean cd /usr/ports/www/moinmoin make config-recursive make install make MOINTYPE=WSGI MOINDEST=/usr/local/www/unit instance exit }}} /usr/local/jails/unit_moinmoin/usr/local/etc/uwsgi.ini {{{#!highlight ini [uwsgi] socket = 10.1.1.9:9000 chmod-socket = 660 chdir = /usr/local/www/unit wsgi-file = moin.wsgi master workers = 2 max-requests = 200 harakiri = 30 die-on-term }}} {{{#!highlight bash jexec unit_moinmoin "service uwsgi start" }}} === 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 }}} |
Puoi modificare la pagina di redirect tramite il link che si presenta nel box in testa alla pagina a cui si rimanda. |
Linee guida: Wiki
Basics
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 che nome attribuirle. 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 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 scelto prima. 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 [[NomeDellaPagina|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
Calendario
Per aggiungere un appuntamento nel calendario premi su uno dei giorni disponibili. Ti si presenterà il normale editor con un template già pronto.
Il titolo (elemento intestazione di primo livello, delimitato da coppie di =) della pagina sarà presente nel tooltip che appare passando col mouse sopra le date impegnate da un appuntamento. Scegli quindi un nome adeguato (generalmente il nome dell'attività).
Redirect
Puoi impostare un redirect da un evento del calendario a una pagina della wiki con la seguente sintassi
#redirect ConnessioniCaotiche2017 = Connessioni Caotiche =
Nota come sia comunque necessario impostare un titolo nella pagina di redirect.
Puoi modificare la pagina di redirect tramite il link che si presenta nel box in testa alla pagina a cui si rimanda.