ikiwiki - Online nel cloud

PROGRAMMA:

NOME

ikiwiki - un compilatore wiki

SINOSSI

ikiwiki [opzioni] origine destinazione

ikiwiki --setup file di configurazione [opzioni]

DESCRIZIONE

ikiwiki è un compilatore wiki. Costruisce pagine HTML statiche per un wiki, dal sorgente nel
ikiwiki/Markdown language (o altri) e lo scrive a destinazione.

Nota che la maggior parte delle opzioni può essere abbreviata in lettere singole, flag booleani come --verbose
può essere negato con --no-verbose e opzioni come --verbose possono anche essere scritte come
-verboso.

MODE VERSIONI

Queste opzioni controllano la modalità in cui opera ikiwiki.

--ricaricare
Aggiorna il wiki, aggiornando le pagine modificate. Questo è il comportamento predefinito se no
è specificata un'altra azione in modalità (ma si noti che --setup è un'azione in modalità e ha
diverso comportamento predefinito).

--ricostruire
Forza una ricostruzione di tutte le pagine.

--setup file di configurazione
Carica le opzioni dal file di installazione specificato. Se non viene specificata alcuna altra modalità di azione,
generare wrapper e ricostruire il wiki, come se si utilizzasse --rebuild --wrapper. Se
vuoi solo costruire tutte le pagine modificate, puoi usare --refresh con --setup.

--changesetup file di configurazione
Legge il file di installazione, aggiunge eventuali modifiche alla configurazione specificate da altre opzioni,
e riscrive la nuova configurazione nel file di installazione. Aggiorna anche qualsiasi
wrapper configurati. In questa modalità, il wiki non viene completamente ricostruito, a meno che tu non sia anche tu
aggiungi --ricostruisci.

Esempio, per abilitare alcuni plugin:

ikiwiki --changesetup ~/ikiwiki.setup --plugin goodstuff --plugin calendario

--dumpsetup file di installazione
Fa sì che ikiwiki scriva nel file di installazione specificato, scaricandone la corrente
configurazione.

--wrapper
Se utilizzato con --setup --refresh, aggiorna anche eventuali wrapper configurati.

--pulire
Questo fa pulire ikiwiki rimuovendo tutti i file che ha generato nella destinazione
directory, nonché eventuali wrapper configurati e la directory di stato .ikiwiki.
Questo è utile soprattutto se stai eseguendo ikiwiki in un Makefile da compilare
documentazione e desidera un obiettivo pulito corrispondente.

--cgi Abilita la modalità CGI. In modalità cgi ikiwiki viene eseguito come script cgi e supporta la modifica
pagine, accesso e registrazione.

Per usare ikiwiki come programma CGI devi usare --wrapper o --setup per generare a
involucro. Il wrapper generalmente dovrà eseguire suid 6755 all'utente che possiede il
directory di origine e destinazione.

--wrapper [file]
Genera un binario wrapper codificato per eseguire l'azione specificata dall'altro
opzioni, utilizzando i file di input e la directory di destinazione specificati. Il nome del file per
l'uso per l'involucro è facoltativo.

Il wrapper è progettato per essere reso sicuro ed essere eseguito da utenti non fidati, come a
post-commit hook, o come CGI.

Nota che il wrapper generato ignorerà tutti i parametri della riga di comando.

--aggregato
Se il plugin/plugin aggregato è abilitato, questo rende configurato ikiwiki poll
feed e salva i nuovi post in srcdir.

Nota che per ricostruire i post precedentemente aggregati, usa l'opzione --rebuild insieme
con questo. --rebuild forzerà anche il polling dei feed anche se lo fossero
interrogato di recente.

--renderizza il file
Rende un singolo file, emettendo l'html risultante. Non salva lo stato, quindi questo
non può essere utilizzato per creare interi wiki, ma è utile per visualizzare in anteprima un file modificato
file nella riga di comando. Generalmente utilizzato in combinazione con --setup per caricare in a
configurazione di wiki:

ikiwiki --setup ~/ikiwiki.setup --render foo.mdwn

--post-commissione
Esegui in modalità post-commit, come se fosse chiamato da un hook post-commit. Questo è
probabilmente utile solo quando si usa ikiwiki con un server web su un host e un
repository su un altro, per consentire al vero hook post-commit del repository di ssh a
l'host del server web ed eseguire manualmente ikiwiki per aggiornare il sito web.

--versione
Stampa il numero di versione di ikiwiki.

CONFIGURA VERSIONI

Queste opzioni configurano il wiki. Nota che i plugin possono aggiungere ulteriori configurazioni
opzioni proprie. Tutte queste opzioni e altre ancora possono essere configurate anche utilizzando a
file di installazione.

--nomewiki nome
Il nome del wiki, di default è "wiki".

--templateir dir
Specificare la directory in cui sono archiviati i modelli. L'impostazione predefinita è
/usr/share/ikiwiki/templates o un'altra posizione configurata in fase di compilazione. Se
la templatedir è cambiata, i template mancanti verranno comunque cercati nel
posizione predefinita come fallback. I modelli possono essere inseriti anche nella cartella "modelli/"
sottodirectory di srcdir.

Nota che se scegli di copiare e modificare i modelli di ikiwiki, dovrai essere
attenzione a tenerli aggiornati quando si aggiorna a nuove versioni di ikiwiki. Vecchio
le versioni dei modelli non funzionano sempre con le nuove versioni di ikiwiki.

--underlaydir
Specificare la directory utilizzata per sottoporre la directory di origine. File sorgenti
verrà preso da qui a meno che non venga sovrascritto da un file nella directory dei sorgenti.
L'impostazione predefinita è /usr/share/ikiwiki/basewiki o un'altra posizione configurata in build
tempo.

--modalità wrapper
Specificare una modalità in cui modificare il wrapper dopo averlo creato.

--wrappergroup
Specifica a quale gruppo unix deve appartenere il wrapper. Questo può essere utile se il
wrapper deve essere di proprietà di un gruppo diverso da quello predefinito. Ad esempio, se a
il progetto ha un repository con più committer con accesso controllato da a
gruppo, ha senso che i wrapper ikiwiki eseguano setgid su quel gruppo.

--rcs=svn|git|.., --no-rcs
Abilita o disabilita l'uso di un revision_control_system.

Si presumerà che la directory di origine sia una copia di lavoro, o un clone, o qualsiasi altra cosa
il sistema di controllo di revisione selezionato utilizza.

In modalità CGI, con un sistema di controllo di revisione abilitato, le pagine modificate via web saranno
essere commesso.

Nessun controllo di revisione è abilitato per impostazione predefinita.

--svnrepo /svn/wiki
Specificare la posizione del repository svn per il wiki.

--svnpath tronco
Specifica il percorso all'interno del tuo repository svn in cui si trova il wiki. Questo
il valore predefinito è trunk; cambialo se la tua wiki si trova in qualche altro percorso all'interno del
deposito. Se il tuo wiki è radicato nella parte superiore del repository, imposta svnpath su "".

--rss, --norss
Se rss è impostato, ikiwiki genererà per impostazione predefinita feed RSS per le pagine che sono in linea a
blog.

--consenti
Se allowrss è impostato e rss non è impostato, ikiwiki non genererà automaticamente RSS
feed, ma l'impostazione di rss=yes nella direttiva inline può sovrascrivere questa impostazione predefinita e
generare un feed.

--atomo, --noatomo
Se atom è impostato, ikiwiki genererà per impostazione predefinita feed Atom per le pagine che sono in linea
un blog

--allowatom
Se allowatom è impostato e rss non è impostato, ikiwiki non verrà generato automaticamente
Feed Atom, ma l'impostazione atom=yes nella direttiva inline può sovrascrivere questa impostazione predefinita
e generare un feed.

--ping URL
Impostalo sull'URL di un servizio XML-RPC per eseguire il ping quando viene aggiornato un feed RSS. Per
esempio, per eseguire il ping di Technorati, utilizzare l'URL http://rpc.technorati.com/rpc/ping

Questo parametro può essere specificato più volte per specificare più di un URL a
ping.

--URL URL
Specifica l'URL del wiki. Questo è un parametro obbligatorio in modalità CGI.

--cgiurl http://example.org/ikiwiki.cgi
Specifica l'URL del wrapper dello script CGI ikiwiki. Necessario quando si costruisce il
wiki per i collegamenti allo script cgi da generare.

--URL URL
Specifica l'URL a cui collegarsi per l'esplorazione della cronologia delle pagine. Nell'URL, "[[file]]" è
sostituito con il file da sfogliare. È comune usare ViewVC per questo.

--adminemail [email protected]
Specifica l'indirizzo email che ikiwiki dovrebbe usare per inviare email.

--diffurlURL
Specifica l'URL a cui collegarsi per una serie di modifiche a una pagina. Nell'URL,
"[[file]]" è sostituito con il file da sfogliare, "[[r1]]" è la vecchia revisione del
pagina e "[[r2]]" è la nuova revisione. È comune usare ViewVC per questo.

--exclude espressione regolare
Specifica una rexexp dei file di origine da escludere dall'elaborazione. Può essere specificato
più volte da aggiungere all'elenco di esclusione.

--include espressione regolare
Specifica un rexexp dei file di origine, che normalmente verrebbe escluso, ma che tu
desidera includere nel trattamento. Può essere specificato più volte da aggiungere per includere
elenco.

--adminnome utente
Specifica un nome utente di un utente (o, se openid è abilitato, un openid) che ha il
poteri di un amministratore wiki. Attualmente consente il blocco di qualsiasi pagina e il divieto degli utenti, come
così come i poteri concessi dai plugin abilitati (come [[moderating
commenti|plugins/commenti moderati]] e plugin/websetup. Può essere specificato
più volte per più amministratori.

Per un utente openid specificare l'URL completo del login, incluso "http://".

--nome plugin
Abilita l'uso del plugin specificato nel wiki. Nota che i nomi dei plugin sono
che tiene conto del maiuscolo o minuscolo.

--disabilita-nome del plugin
Disabilita l'uso di un plugin. Ad esempio "--disable-plugin htmlscrubber" da eliminare
con sanificazione HTML.

directory --libdir
Fa in modo che ikiwiki guardi prima nella directory specificata, prima delle posizioni normali
durante il caricamento di file di libreria e plug-in. Ad esempio, se imposti libdir su
"/home/you/.ikiwiki/", puoi installare un plugin foo.pm come
"/home/you/.ikiwiki/IkiWiki/Plugin/foo.pm".

--discussione, --nessuna discussione
Abilita o disabilita l'aggiunta di collegamenti "Discussione" all'intestazione di ogni
pagina. I collegamenti sono abilitati per impostazione predefinita.

--numbacklink n
Controlla quanti backlink devono essere visualizzati nella parte inferiore di una pagina. Eccesso
i backlink saranno nascosti in un popup. Il valore predefinito è 10. Imposta su 0 per disabilitarlo
caratteristica.

--userdir sottodirectory
Facoltativamente, consente ai collegamenti agli utenti del wiki di collegarsi a pagine all'interno di a
sottodirectory del wiki. L'impostazione predefinita è collegarsi alle pagine nella directory di primo livello
del wiki.

--htmlexthtml
Configura l'estensione utilizzata per i file html generati. L'impostazione predefinita è "html".

--formato orario
Specificare come visualizzare l'ora o la data. La stringa di formato viene passata a
strftime(3) funzione.

--verbose, --no-verbose
Sii prolisso su ciò che viene fatto.

--syslog, --no-syslog
Accedi syslog(3).

--useirs, --no-useirs
Attiva/disattiva la creazione di file di output denominati page/index.html (predefinito) invece di page.html.

--direttive-prefisso, --no-direttive-prefisso
Attiva/disattiva la nuova sintassi con prefisso '!' per le direttive del preprocessore. ikiwiki attualmente
il valore predefinito è --prefix-directives.

--w3mode, --no-w3mode
Abilita w3mmode, che consente a w3m di utilizzare ikiwiki come script CGI locale, senza a
server web.

--sscookie
Invia i cookie solo tramite una connessione SSL. Questo dovrebbe impedire loro di essere
intercettato. Se abiliti questa opzione, devi eseguire almeno la parte CGI
di ikiwiki su SSL.

--gettime, --no-gettime
Estrai i tempi di creazione e modifica per ogni nuova pagina dalla revisione
registro di controllo. Questo viene fatto automaticamente quando si costruisce un wiki per la prima volta,
quindi normalmente non è necessario utilizzare questa opzione.

--set var=valore
Ciò consente di impostare una variabile di configurazione arbitraria, come se fosse impostata
tramite un file di installazione. Poiché le opzioni più comunemente utilizzate possono essere configurate utilizzando
opzioni della riga di comando, raramente sarà necessario utilizzarle.

--set-yaml var=valore
È come --set, ma consente di impostare variabili di configurazione che utilizzano complex
strutture dati, passando in un documento YAML.

ESEMPI

ikiwiki --setup mio.setup

(ri)costruisci completamente il wiki utilizzando il file di installazione specificato.

ikiwiki --setup mio.setup --refresh
Aggiorna il wiki, utilizzando le impostazioni di my.setup, ed evita di ricostruire le pagine che
non sono cambiati. Questo è più veloce.

ikiwiki --setup mio.setup --refresh --wrappers
Aggiorna il wiki, inclusa la rigenerazione di tutti i programmi wrapper, ma non ricostruire
tutte le pagine. Utile se hai cambiato qualcosa nel file di installazione che non lo fa
hai bisogno di una ricostruzione completa della wiki per aggiornare tutte le pagine, ma che vuoi prendere immediatamente
effetto.

ikiwiki --rebuild srcdir destdir
Usa srcdir come sorgente e crea HTML in destdir, senza usare un file di installazione.

ikiwiki srcdir destdir
Usa srcdir come sorgente per aggiornare l'HTML delle pagine modificate in destdir, senza usare a
file di installazione.

AMBIENTE

CC

Questo controlla quale compilatore C viene utilizzato per creare i wrapper. L'impostazione predefinita è "cc".

CFLAGS Questo può essere usato per passare opzioni al compilatore C durante la creazione di wrapper.

Usa ikiwiki online usando i servizi onworks.net