ArcheoServer-Editor HOWTO

Transcript

1 ArcheoServer-Editor HOWTO Andrea Bonomi - andrea.bonomi@gmail.com September 8, 2006 Version Introduzione Questo documento si propone di descrivere le operazioni di base necessarie per creare e modificare contenuti sul portale ArcheoServer. Il portale è stato sviluppato utilizzando SnipSnap 1, un applicazione Web per gestire contenuti secondo il paradigma Wiki Wiki Web 2. Una caratteristica distintiva di questa tecnologia è la facilità con cui le pagine possono essere create e aggiornate da diversi autori. Creare una pagina in un sistema Wiki è molto diverso rispetto a scrivere con un comune word processor (come, ad esempio, Microsoft Word). In un Wiki, gli autori devono scrivere le pagine secondo uno specifico formalismo (chiamato wikitext ) che permette di descrivere come dovranno essere visualizzati gli elementi nella pagina. Ad esempio, in SnipSnap, per visualizzare una parola in italico è necessario farla precedere e seguire da due caratteri di sottolineatura mentre per inserire un link ad un altra pagina del sito è necessario racchiudere il suo nome tra due parentesi quadre. Questo formalismo, che a prima vista può apparire un po ostico, permette, una volta imparato, di editare molto velocemente ed in totale autonomia pagine Web, di inserire collegamenti tra le pagine del sito e con altri siti e di posizionare immagini. Figure 1: Homepage dell ArcheoServer

2 2 Primi passi La condizione necessaria per poter creare e modificare pagine del portale Archeo- Server è avere un utente con il ruolo Editor. É possibile verificare di avere questo ruolo controllando che, dopo aver effettuato il login (attraverso il box presente nella colonna di destra del sito), compaia in ogni pagina un menu come il seguente: Figure 2: Esempio di menu visualizzato da un utente Editor La principale differenza con il menu visualizzato dagli utenti comuni è la presenza dei link modifica e nuova che servono rispettivamente per modificare la pagina corrente e per creare nuove pagine. Per imparare come si realizzano le pagine del portale, può essere utile fare le prime prove sulla propria pagina personale. Ogni utente del portale ha una sua pagina, reperibile attraverso l indice. La propria pagina è facilmente identificabile nell indice perché ha come nome il proprio username. Dopo aver visualizzato la pagina, è possibile editarla cliccando sul link modifica. Dopo aver premuto questo link, comparirà una pagina contenente un form come il seguente: Figure 3: Form di modifica della propria pagina personale Scrivendo del testo all interno del box di testo, è possibile modificare il contenuto della pagina corrispondente. Attraverso il bottone Vai all Help è possibile visualizzare un elenco di stili di formattazione delle pagine nel portale, Anteprima permette di visualizzare come la pagina sarà visualizzata dagli utenti, Salva permette di memorizzare le modifiche effettuate e Annulla di ritornare alla visualizzazione della pagina senza salvare. Questa pagina permette di fare i primi esperimenti di modifica delle pagine del portale: si può provare, ad esempio, a fare copia e incolla di un testo e osservare come viene visualizzato all interno del portale. Se si è copiato nel portale un testo formattato da un word processor (ad esempio, da Microsoft Word) si noterà come la formattazione (carattere usato, dimensione, colori, italico e grassetto) siano andate perdute. Questo avviene perché il sistema Wiki impone uno 2

3 stile standard per tutti i contenuti del sito. Ciononostante è possibile specificare alcuni stili del testo, come ad esempio italico e grassetto e alcuni tipi di struttura come le liste puntante e numerate. Ad esempio, per scrivere una parte del testo in corsivo, è necessario farlo precedere da due caratteri di tilde 3 ( ). Il testo continuerà ad essere corsivo fino alla presenza di un altra coppia. Ad esempio, se si scrive il seguente testo: testo normale ~~testo in corsivo~~ altro testo normale nella pagina visualizzata dagli utenti esso apparirà nel seguente formato: testo normale testo in corsivo altro testo normale Per imparare a formattare i testi delle pagine, è possibile sfruttare la funzionalità di anteprima, cioè provare a modificare il testo, cliccare sul tasto omonimo e osservare come viene visualizzato. 3 Formattazione dei testi Una delle prime differenze che emergono tra il testo che viene inserito in box di scrittura e la sua controparte nella pagina è il modo in cui viene gestito il carattere di fine linea ( a capo ), ad esempio, se nel box scriviamo: uno due tre quattro nell anteprima potremo osservare che il testo verrà visualizzato tutto sulla stessa linea: uno due tre quattro Questo comportamento è dovuto al fatto che il sistema Wiki si occupa completamente della formattazione del testo, cioè decide lui quando andare a capo. Il Wiki prevede che l utente decida di andare a capo solo tra un paragrafo e l atro; per specificare la fine di un paragrafo è necessario inserire una linea vuota, ad esempio, il seguente testo: L abitato protostorico di Mursìa e la relativa necropoli monumentale de "i Sesi" costituiscono uno dei complessi archeologici più importanti e meglio conservati del Mediterraneo centrale. L abitato è collocato tra l area pianeggiante di Cala Modica e la Cala dell Alca, in corrispondenza del fronte della colata lavica del Gelkhamar. Il luogo è difeso naturalmente su tre lati con una scogliera alta circa 30 m, mentre la parte interna è difesa... verrà visualizzato nel seguente formato: L abitato protostorico di Mursìa e la relativa necropoli monumentale de i Sesi costituiscono uno dei complessi archeologici più importanti e meglio conservati del Mediterraneo centrale. 3 Nella tastiera italiana il carattere tilde non è presente, comunque in Windows si può ottenere tenendo premuto il tasto alt gr e digitando la sequenza sul tastieruno numerico, mentre sul Mac premendo contemporaneamente il tasto alt e il numero 5. 3

4 L abitato è collocato tra l area pianeggiante di Cala Modica e la Cala dell Alca, in corrispondenza del fronte della colata lavica del Gelkhamar. Il luogo è difeso naturalmente su tre lati con una scogliera alta circa 30 m, mentre la parte interna è difesa... Ulteriori comandi utili per la formattazione dei testi sono quelli relativi agli stili corsivo, grassetto. Come è già stato mostrato in precedenza, per ottenere un testo scritto in corsivo è sufficiente scrivere due caratteri di tilde ( ) prima del testo da formattare e due dopo. Un procedimento analogo si attua per scrivere del testo in grassetto: in questo caso, è necessario utilizzare due caratteri di sottolineature ( ) prima del blocco da scrivere in grassetto e due alla fine del medesimo. 4 Titoli Il sistema Wiki non permette di modificare a piacere la dimensione dei caratteri, permette però di specificare dei titoli per i paragrafi e i sotto-paragrafi che verranno visualizzati con un carattere più grande. Per creare il titolo di un paragrafo bisogna iniziare una linea nuova con il carattere uno ( 1 ) seguito da uno spazio e dal titolo del paragrafo, ad esempio: 1 Credits Testo del paragrafo... verrà visualizzato con il carattere, la dimensione e lo stile del titolo del paragrafo. Il carattere 1 viene utilizzato unicamente per indicare che il contenuto della riga è il titolo del paragrafo, non ha nulla a che fare con la numerazione dei paragrafi. Tutti i titoli di paragrafo hanno come marcatore 1, quindi il secondo paragrafo avrà sempre il numero uno per indicare che è un titolo, non 2, 3, ecc... Oltre che lo stile titolo paragrafo è disponibile anche un altro stile chiamato titolo sotto-paragrafo. Per creare un titolo di sotto-paragrafo (che verrà visualizzato più in piccolo rispetto al titolo di un paragrafo) è necessario iniziare la riga con la sequenza di caratteri uno punto uno ( 1.1 ) seguita da uno spazio e dal titolo del sotto paragrafo, ad esempio:...testo del sotto paragrafo precedente. 1 I primi ritrovamenti Testo del sotto paragrafo... 4

5 5 Liste puntate Per creare una lista puntata, è necessario inserire ogni elemento della lista in una nuova riga preceduto dal carattere asterisco ( * ), ad esempio: * prima riga * seconda riga * terza riga produrra la visualizzazione di una lista puntata simile alla seguente: prima riga seconda riga terza riga È possibile avere uno stile differente di lista utilizzando il carattere meno ( - ) al posto dell asterisco. 6 Liste numerate La creazione di lista numerate è simile alla creazione di liste puntate. Per creare una lista numerata, ogni riga della lista dovrà essere preceduta dai caratteri numero e da un punto ( 1. ). Non solo la prima riga della lista dovrà cominciare con il numero uno, ma anche le successive. Il sistema si occuperà autonomamente di numerare in ordine crescente gli elementi della lista. Ad esempio: 1. prima riga 1. seconda riga 1. terza riga verrà visualizzato come: 1. prima riga 2. seconda riga 3. terza riga 7 Link Un punto di forza dei sistemi Wiki rispetto ai CMS 4 (Content Management System) è la semplicità con cui è possibile creare collegamenti ipertestuali tra le pagine. Nelle pagine dell ArcheoServer è possibile sia inserire collegamenti verso altre risorse interne al portale che link verso siti esterni. Per creare un collegamento verso un altra pagina del sito è necessario conoscerne il suo identificativo. L identificativo di una pagina è composto dalla gerarchia sotto cui si trova la pagina e dal nome della pagina stessa, ad esempio, la pagina relativa agli scavi Mursia - Pantelleria (TP) che è situata nella 4 Vedi Management System 5

6 sezione Scavi, che a sua volta è sotto Ricerche, ha come identificativo Ricerche/Scavi/Mursia - Pantelleria (TP). Se visualizziamo la pagina di Mursia, nel riquadro in alto possiamo vedere il suo percorso completo. Un ulteriore esempio è presentato in Figura 2 in cui si può vedere l indirizzo completo della pagina Partner, cioè start/partner e redazione/partner. Se creiamo una nuova pagina a partire dal Mursia, che chiameremo, ad esempio, Scoperte Recenti, essa avrà come identificativo Ricerche/Scavi/Mursia - Pantelleria (TP)/Scoperte Recenti. L identificativo di una pagina è importante perché permette di creare collegamenti ipertestuali tra le pagine del sito, nello stesso modo in cui gli URL 5 (Uniform Resource Locator) permettono di creare collegamenti tra pagine di siti web differenti. Per inserire un link verso una pagina interna al portale, è necessario scrivere il percorso della risorsa che si vuole collegare circondato da parentesi quadre, ad esempio, per creare un link verso la pagina relativa a Mursia, si deve utilizzare il seguente codice: [Ricerche/Scavi/Mursia - Pantelleria (TP)] La sintassi per creare link verso risorse esterne al portale è differente rispetto a quella mostrata. Per creare un link verso un alto sito, è necessario specificare nel testo il suo indirizzo (URL) completo (cioè preceduto da ), ad esempio, se si vuole inserire in una pagina un link al sito si può utilizzare il seguente codice: Istituto italiano di Preistoria e Protostoria 8 Allegati Ad ogni pagina del portale è possibile allegare dei documenti (ad esempio, pdf, immagini). Dopo aver effettuato il login, nella parte in fondo di ogni pagina verrà visualizzata la sezione File Allegati che presenta tutti i documenti allegati alla pagina corrente. Attraverso il link aggiungi file è possibile accedere alla gestione degli allegati. Figure 4: Elenco File Allegati Per allegare un nuovo documento: Dalla pagina di gestione degli allegati, cliccare sul tasto Sfoglia... 5 Un URL è una sequenza di caratteri che identifica l indirizzo di una risorsa in Internet 6

7 Selezionare il file da allegare e premere Ok Cliccare sul tasto Invia File A seconda della dimensione del file e della velocità della propria connessione, la procedura di invio del file impiegherà più o meno tempo. Dopo che il file è stato inviato correttamente, il suo nome comparirà nell elenco dei file allegati alla pagina. Per rimuovere un file, spuntare la casellina corrispondente e premere il tasto Cancella File Figure 5: Pagina per la modifica degli allegati 9 Immagini Nelle pagine del portale è possibile inserire delle immagini precedentemente allegate. Attraverso il seguente codice è possibile inserire una immagine all intero di una pagina: {image:img=nome.gif} dove nome.gif è il nome dell immagine che si vuole visualizzare. Il portale permette di inserire immagini gif, jpg e png. Per poter inserire immagini in altri formati (ad esempio, tiff) è necessario convertirle prima di allegarle alla pagina. L immagine inserita verrà visualizzata nella pagina allineata a sinistra e nel punto in cui è stato inserito il codice corrispondente (cioè, se il tag viene inserito tra due paragrafi, l immagine apparirà al posto del tag tra i due paragrafi). Tramite il seguente codice, è possibile inserire un immagine allineata a destra: {image:img=nome.gif align=float-right} Se ad una pagina sono associate numerose immagini, un ulteriore possibilità è la creazione di una galleria di immagini. La galleria permette con un singolo tag di visualizzare un riquadro in cui compare la preview delle singole immagini su cui è possibile cliccare per visualizzare ingrandite. Per creare la galleria si utilizza il seguente tag: 7

8 {attachmentgallery} Per un ottimale visualizzazione della pagina, è consigliabile inserire il codice per la galleria come primo codice all inizio della pagina. Figure 6: Esempio di galleria di immagini 10 Conclusioni Nelle pagine precedenti sono state illustrate le funzionalità di base per la gestione dei contenuti del portale ArcheoServer: creazione e modifica delle pagine, formattazione del testo, titoli, elenchi puntati e numerati, upload di allegati, inserimento di immagini e di collegamenti ipertestuali. Dopo aver letto questo documento, non vi resta che fare esperienza sia provando a creare nuove pagine che visualizzando il codice delle pagine esistenti per vedere come sono state realizzate. La versione più recente di questo documento può essere reperita nella sezione Help e FAQs del portale. 8