Direttive per pagine

PmWiki mette a disposizione un discreto numero di direttive, che permettono di specificare per ciascuna pagina il titolo, una descrizione e le parole chiave collegate. È anche possibile controllare la visualizzazione di alcuni componenti.

(:attachlist:)
Elenca gli allegati del gruppo corrente (o della pagina corrente, a seconda di come è organizzato il sito). Questa lista viene mostrata in fondo alla pagina uploads.
È possibile specificare il nome di una pagina, come parametro per (:attachlist:). La direttiva visualizzerà gli allegati disponibili su tale pagina.
Opzioni
(:attachlist NOME:) mostra una lista degli allegati al gruppo o alla pagina NOME.
(:attachlist ext=xxx:) mostra solo i file con l'estensione specificata.
(:attachlist *:) mostra la directory che contiene i file caricati, e permette di visualizzarne il contenuto (funziona solo se $EnableDirectDownload non è 0).

(:description text:)
Specifica una descrizione della pagina. (Genera un elemento HTML <meta name='description' content='...' />.)

(:keywords word1, word2, ...:)
Specifica le parole chiave associate con la pagina. Queste non vengono visualizzate, ma sono utilizzate dai motori di ricerca. (In pratica, genera un elemento HTML <meta name='keywords' content='...' />.)

(:linebreaks:), (:nolinebreaks:)
Fa sì che le interruzioni di linea nel sorgente della pagina vengano visualizzate. (:nolinebreaks:) ripristina il comportamento standard: le interruzioni di linea nel markup vengono di nuovo ignorate.

(:linkwikiwords:), (:nolinkwikiwords:)
Abilita o disabilita il riconoscimento delle WikiWord come collegamenti.

(:markup:) ... (:markupend:)
Può essere utilizzata per mostrare esempi di uso del markup: inserisce una tabella nella quale viene mostrato il markup accanto al risultato corrispondente.
Opzioni
(:markupend:) non è necessario se si usa (:markup:) [=...=].
Parametri: (:markup class=horiz:) e (:markup caption='...':)

(:noaction:)
Nasconde la sezione delimitata da <!--PageActionFmt--> e <!--/PageActionFmt--> nella skin. Nella skin fornita con PmWiki, tale sezione contiene le azioni elencate nell'angolo in alto a destra di ciascuna pagina ("Modifica", "Versioni", ecc.). Altre skin potrebbero avere questa sezione in un'altra parte della pagina.

(:nogroupheader:)
(:nogroupfooter:)
Disabilita le intestazioni o i pié di pagina impostati dal gruppo (si veda GroupHeaders?).

(:noheader:), (:nofooter:)
(:noleft:), (:noright:), (:notitle:)
Se supportate dalla skin?, queste direttive nascondono ciascuna una parte della pagina.

(:redirect PageName:)
(:redirect PageName#anchor:)
Effettua un redirect verso un'etichetta all'interno di un'altra pagina
(:redirect PageName status=301 from=name:)
Effettua un redirect verso un'altra pagina e mostra un messaggio. Per motivi di sicurezza, questa direttiva funziona solo con pagine sullo stesso wiki, e non verso siti esterni. L'opzione status= permette di impostare un codice HTTP insieme al redirect. L'opzione from= fa sì che le redirezioni avvengano solo su pagina che corrispondono all'espressione name (può contenere carattery jolly). Quest'ultima opzione è utile se la direttiva (:redirect:) si trova in un'altra pagina.

(:spacewikiwords:), (:nospacewikiwords:)
Abilita o disabilita l'inserimento automatico di spazi all'interno delle WikiWord.

(:title text:)
Imposta il titolo della pagina. Questo può contenere apostrofi o altri caratteri speciali. Se sono presenti più direttive (:title :), vale l'ultima incontrata.

(:nl:)
Inserisce un'interruzione di linea, se non è appena stata inserita. Si veda questo thread per ulteriori informazioni.
L'effetto è simile a quello di [[<<]]

<< Page lists? | Indice documentazione | Deleting pages? >>

È possibile associare un codice HTTP 301 ("moved permanently" -- pagina spostata definitivamente) a un (:redirect:)?

Sì: (:redirect PageName status=301:).

È possibile evitare che venga mostrato il messaggio "rediretto da" in cima alle pagine che usano (:redirect:)?

Ci sono diverse possibilità.

Per disabilitare il messaggio in tutto il sito

  • aggiungere $PageRedirectFmt = ''; nel file local/config.php

Per disabilitare il messaggio a seconda della destinazione del redirect

  • aggiungere $PageRedirectFmt = ''; a un file local/group.page.php o local/group.php (si veda Group Customizations).

Per disabilitare il messaggio in base all'origine del redirect

  • aggiungere al file local/config.php le seguenti linee:
if (@$_GET['from']) {
  $group = PageVar($_GET['from'], '$Group');
  if ($group == 'IlMioGruppo') $PageRedirectFmt = '';
}
(In questo esempio, IlMioGruppo può essere sostituito con Profiles.)

Un'alternativa è l'inclusione delle altre pagine, anziché il redirect.

Queste due ricette del cookbook potrebbero essere utili:

C'è un modo per rimandare alla stessa pagina, ma in un altro gruppo? Ad esempio da BadGroup/thispage a GoodGroup/thispage usando un markup simile a (:redirect Goodgroup.{Name}:)?

(:redirect Goodgroup.{$Name}:) funziona se inserito in ciascuna pagina.
Per l'intero gruppo, bisogna inserire (:redirect Goodgroup.{*$Name}:) in Badgroup.GroupHeader. Questo, però, funziona solo per pagine che esistono in Goodgroup: se si ricerca una pagina in Badgroup che non ha una pagina corrispondente in Goodgroup, allora la direttiva non funziona e viene mostrata tale e quale, insieme al testo della pagina di Badgroup.
Inserendo (:if exists Goodgroup.{*$Name}:)(:redirect Goodgroup.{*$Name}:)(:ifend:) in Badgroup.GroupHeader si ottiene che il redirect verso Goodgroup.Name viene effettuato se tale pagina esiste, altrimenti viene mostrata la pagina Badgroup.Name, ma senza questo codice.


Traduzione di PmWiki.PageDirectives - Pagina originale: PmWikiIt.PageDirectives - Backlinks
Ultime modifiche:
PmWikiIt.PageDirectives: September 10, 2011, at 10:52 AM
PmWiki.PageDirectives: April 19, 2024, at 04:24 PM