Locked History Actions

AiutoSuInstallazionePacchetto

Introduzione

Vi siete mai chiesti come mai ci sono così tante pagine? È dovuto al fatto che non c'è un metodo per fornire tutte le pagina di aiuto in un unico file. O perché installare un tema non è facile dato che non si sa mai dove mettere i file?

L'installatore di pacchetto è un framework per script per MoinMoin che semplifica l'installazione di estensioni per MoinMoin.

È possibile usare questo sistema per creare "pacchetti" di modelli specifici per rendere MoinMoin un sistema CRM, oppure è possibile rendere i propri plug-in/temi più facili da installare.

Installare un pacchetto

I super-utenti (quelli contenuti nella lista superuser della configurazione) scaricheranno il pacchetto, lo caricheranno sul wiki e quindi installeranno il pacchetto direttamente nella pagina degli allegati. Inoltre, possono installare il pacchetto usando la riga di comando (MoinMoin/packages.py i pacchetto.zip).

Creare pacchetti

È possibile creare un pacchetto in diversi modi, come usare l'azione PackagePages per crearne uno automaticamente, oppure è possibile farlo a mano. Basta creare un file zip contenente i file e un file speciale chiamato MOIN_PACKAGE, lo script di installazione. Questo script contiene un comando per ogni riga e viene eseguito dall'alto verso il basso. Consultare l'esempio:

MoinMoinPackage|1
ReplaceUnderlay|miapagina.txt|AiutoContenuti
AddRevision|miapagina2.txt|PaginaPrincipale
InstallPlugin|mioparser.py|global|parser|mioparser.py
  • La prima riga indica che il file è uno script e imposta la revisione, per ora è a 1.
  • La seconda riga sostituisce la versione underlay della pagina AiutoContenuti con il file miapagina.txt.

  • La terza riga aggiunge una revisione alla pagina PaginaPrincipale, per esempio la cambia.

  • La quarta riga installa un nuovo processore.

Comandi implementati

I comandi non fanno distinzione tra maiuscolo e minuscolo.

  • Print|testo

    • Stampa il testo come output, l'utente lo vedrò successivamente.
  • IgnoreExceptions|booleano

    • Imposta l'eccezione ignore. Se le eccezioni vengono ignorate, lo script non si ferma quando ne viene incontrata una.

  • SetThemeName|nometema

    • Imposta il nome del tema che verrà modificato in seguito.
  • CopyThemeFile|nomefile|tipo|obiettivo

    • Copia un file di un tema (CSS, PNG, etc.) nella directory del tema corrente.
    • Attualmente è solo supportato sui server tipo standalone.
    • Esempio: CopyThemeFile|screen.css|css|screen.css

  • InstallPlugin|nomefile|visibilità|tipoplugin|obiettivo

    • Copia un plugin da nomefile a obiettivo. Visibilità può essere local in cui viene selezionata la cartella dei plug-in del wiki corrente o global che seleziona la cartella del pacchetto python di MoinMoin; tipoplugin può essere parser, macro, etc.

    • Esempio: InstallPlugin|mioparser.py|global|parser|mioparser.py

  • AddRevision|nomefile|nomepagina|autore|commento|banale

    • Aggiunge una revisione (letta dal file nomefile) alla pagina nomepagina. autore specifica il nome di chi fa la modifica ed è facoltativo. commento specifica il commento per la revisione ed è facoltativo, banale indica se la modifica è da considerarsi banale ed è facoltativo.

    • Esempio (installa un nuovo modello):

      AddRevision|cust.tpl|AcquirenteModello
      AddRevision|phone.tpl|TelefonoModello
  • DeletePage|nomepagina|commento

    • Cancella la pagina nomepagina, opzionalmente impostando anche un commento.

    • Esempio: DeletePage|PaginaPrincipale

  • ReplaceUnderlay|nomefile|nomepagina

    • Sostituisce la versione underlay della pagina. Può essere utilizzato per installare pagine underlay o per aggiornarle.

  • EnsureVersion|versione|righe

    • Termina lo script o salta righe se il criterio della versione non corrisponde e righe è specificato.

    • Il seguente esempio fornisce due parser e installa quello corretto:

      EnsureVersion|1.3.3|2
      InstallPlugin|mioparser.py_3|global|parser|mioparser.py
      Exit
      EnsureVersion|1.3.2
      InstallPlugin|mioparser.py_2|global|parser|mioparser.py
  • Exit

    • Ferma lo script.
  • InstallPackage|Nomepagina|Nomefile

    • Installa un altro pacchetto che deve essere un allegato chiamato Nomefile della pagina Nomepagina.

    • Esempio: InstallPackage|PaginaPrincipale|IlMioPlugin.zip

  • AddAttachment|nome file nel file zip|nomefile|nomepagina|autore|commento

    • Esempio: AddAttachment|2_attachment|song.wav|PaginaPrincipale|PincoPallino|una canzone di esempio.

  • DelAttachment|nomefile|nomepagina|autore|commento

    • Esempio: DelAttachment|canzone.wav|PaginaPrincipale|PincoPallino|prova

  • RenamePage|nomepagina|nuovo nome|autore|commento

    • Rinomina una pagina.