Differences between revisions 1 and 27 (spanning 26 versions)
Revision 1 as of 2016-10-03 10:43:03
Size: 3801
Editor: crudo
Comment: Guida all'installazione
Revision 27 as of 2017-09-15 09:35:52
Size: 3366
Editor: crudo
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from Wiki
Line 4: Line 5:
= Wiki = = Linee guida: Wiki =
Line 6: Line 7:
== Installazione == == Basics ==
Consiglio: puoi leggere il codice di altre pagine premendo il tasto `Edit`
o `More Actions:` → `Raw Text`. ;)
Line 8: Line 11:
La wiki è gestita da MoinMoin 1.9 in esecuzione su FreeBSD 10.2
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 12: 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 già 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.

{{{#!highlight bash
zfs create /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 29: 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 31: Line 71:
exec.start = "/bin/sh /etc/rc";
exec.stop = "/bin/sh /etc/rc.shutdown";
exec.clean;
#redirect ConnessioniCaotiche2017
Line 35: 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 63: 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 68: Line 78:
/usr/local/jails/unit_moinmoin/etc/rc.conf
{{{
uwsgi_enable="YES"
uwsgi_flags="-T --ini /usr/local/www/unit/uwsgi.ini"
}}}

/usr/local/jails/unit_moinmoin/etc/make.conf
{{{
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/http-proxy/usr/local/etc/nginx/sites-available/wiki.unit.macaomilano.org.conf
{{{
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;
  }
}
}}}

{{{#!highlight bash
jexec http-proxy "ln -s 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
}}}


{{{#!highlight bash
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/www/unit/uwsgi.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"
}}}
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 :D

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.

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