[Revista Latam] pool/DokuWiki pool/historial_bash

Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica revista-fedora-latam en lists.fedorahosted.org
Vie Feb 25 09:15:07 UTC 2011


 pool/DokuWiki/dokuwiki.tex   |  107 +++++++++++++++++++++++++++++++++++++++++++
 pool/DokuWiki/dokuwiki_1.txt |   21 ++++++++
 pool/historial_bash          |   10 ++++
 3 files changed, 138 insertions(+)

New commits:
commit a1a14ecae704a6572bc8aef4b19b757f25a9e9dd
Author: Jesús E. Franco Martínez <tezcatl en riseup.net>
Date:   Fri Feb 25 03:06:03 2011 -0600

    Trabajo inicial en tutorial de DokuWiki y COMOs de Bash

diff --git a/pool/DokuWiki/dokuwiki.tex b/pool/DokuWiki/dokuwiki.tex
new file mode 100644
index 0000000..947ae2f
--- /dev/null
+++ b/pool/DokuWiki/dokuwiki.tex
@@ -0,0 +1,107 @@
+\documentclass[10pt,oneside]{article}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage[italian]{babel}
+
+\usepackage{vmargin}                      
+\setmarginsrb{12mm}{5mm}{12mm}{8mm}%
+             {0mm}{10mm}{0}{10mm}
+
+\usepackage{listings}
+         \lstset{basicstyle=\small\ttfamily,
+         frame=lines}
+%\lstset{frame=lines}
+\usepackage{hyperref,graphicx}
+\usepackage{lipsum}
+\newcommand{\mail}[1]{\href{mailto:#1}{\texttt{#1}}}
+\newcommand{\tx}[1]{\texttt{#1}}
+
+%permette di togliere la numerazione alle pagine
+\makeatletter
+\let\ps en plain\ps en empty
+\ps en empty
+\makeatother  
+
+\begin{document}
+\begin{center}
+\begin{huge}
+Installazione Dokuwiki\\
+\end{huge}
+\begin{Large}
+Bonacina Alberto\\
+\mail{bonacina.alberto en gmail.com}
+\end{Large}
+\end{center}
+
+\subsection*{Descrizione Piattaforma}
+DokuWiki\footnote{http://www.dokuwiki.org/dokuwiki} è un software wiki semplice da installare rilasciato sotto licenza GPL 2 e scritto in PHP. Sul sito del progetto si legge che il suo target è quello di team di sviluppo, gruppi di lavoro e piccole aziende. Il suo utilizzo è finalizzato principalmente alla creazione di documentazione di qualsiasi tipo; la sintassi è molto simile a quella di altri software per wiki e tutti i contenuti sono gestiti attraverso file di testo. Queste sue caratteristiche lo rendono molto facile da installare e permette di avere a disposizione una piattaforma wiki in poco tempo
+
+\subsubsection*{Principali Caratteristiche}
+Dokuwiki presenta una sintassi adatta per chi vuole contribuire fin da subito alla documentazione ma non ha voglia di perdersi in una sintassi difficile fa imparare, nella pagina di modifica viene messa a disposizione una barra con delle icone per modificare il testo come un normale word processor come OpenOffice Writer. \\
+Possibilità di inserire immagini nei formati gif, jpeg, jpg, png e documenti nei formati pdf, ps, doc, xls, ppt, formati open document di OpenOffice; Possibilità di modificare il tema del wiki per adattarlo alle proprie esigenze. Su sito del progetto alla sezione dei template sono presenti circa 60 temi diversi che si possono installare molto facilmente, tra i temi disponibili c'è anche quello presente di default sulla pagina di Wikipedia; Dokuwiki mette a disposizione la funzione di ricerca che consente di ricercare una parola all'interno di tutto il wiki e come risultati vengono mostrate tutte le pagine che contengono la risorsa desiderata.
+
+\subsection*{Installazione}
+Per poter scaricare Dokuwiki andiamo con il nostro browser alla pagina \url{http://www.splitbrain.org/projects/dokuwiki} e scarichiamo il pacchetto \tx{dokuwiki-2009-12-25c.tgz}. Spostiamoci nella cartella in cui l'abbiamo scaricato e scompattiamolo, da terminale può essere fatto con
+\begin{lstlisting}
+tar -zxf  dokuwiki-2009-12-25c.tgz
+\end{lstlisting}
+a questo punto avremo una cartella chiamata \tx{dokuwiki-2009-12-25}, per comodità rinominiamola in \tx{dokuwiki} con il comando
+\begin{lstlisting}
+ mv dokuwiki-2009-12-25/ dokuwiki/
+\end{lstlisting}
+Per comoditià abbiamo installato Dokuwiki in locale, nella mia Fedora 13 la cartella radice del webserver è \tx{/var/www/html/}. Spostiamo tutta la cartella di Dokuwiki, appena rinominata, nella cartella del webserver con il comando
+\begin{lstlisting}
+ sudo cp -R dokuwiki/ /var/www/html/
+\end{lstlisting}
+ho dato il comando da superutente in quanto l'utente del computer non ha i privilegi di scrittura nella cartella \tx{/var/www/html/}. Possiamo ora spostarci nella cartella \tx{/var/www/html/} e verificare che la copia sia andata a buon fine. Per far partire l'installazione è sufficiente aprire un browser e andare all'indirizzo \url{http://localhost/dokuwiki/install.php}. Verranno mostrati una serie di errori in quanto, per ora, l'installer di Dokuwiki non ha i privilegi di scrittura nelle cartelle del webserver (motivo per cui ho dovuto dare sudo quando ho fatto la copia), per risolvere questo problema basta dare da terminale
+\begin{lstlisting}
+cd /var/www/html/dokuwiki/
+sudo chmod o+w -R conf/ data/
+\end{lstlisting}
+Facendo il refresh della pagina, l'installazione potrà partire senza problemi e dovremo mettere tutte le informazioni sul nostro wiki come il nome, utente amministratore, password ed email, quando avremo compilato tutti i campi potremo lanciare l'installazione. Ci verrà mostrata una pagina in cui viene confermato che Dokuwiki è stato installato nella maniera corretta. Come ultimo passo eliminiamo il file \tx{install.php} con il comando
+\begin{lstlisting}
+sudo rm /var/www/html/dokuwiki/install.php
+\end{lstlisting}
+La prima pagina del wiki sarà raggiungibile all'indirizzo \url{http://localhost/dokuwiki/doku.php}, per cominciare a fare qualche modifica andiamo nella parte bassa della pagina e clicchiamo su \tx{login}, immettiamo nome utente e password. Fatto questo clicchiamo su Admin e ci troveremo davanti il pannello di amministrazione. Le voci che ci troveremo davanti sono:
+\begin{itemize}
+      \item[-] \textbf{User Manager:} permette di gestire gli iscritti al wiki, cambiare le loro credenziali, abilitare/iscrivere nuovi utenti;
+      \item[-] \textbf{Access Control List Management:} permette di gestire i gruppi di utenti e i loro permessi all'interno del Wiki. E' possibile per esempio creare un gruppo per gli utenti che sono abilitati solo a correggere le pagine ma non a crearle, oppure si può creare un gruppo di utenti che possa solo cancellare le pagine ma non modificarle o crearle;
+      \item[-] \textbf{Manage Plugins:} permette di avere una visione completa dei plugins installati e i rimandi alle pagine di ufficiali di documentazione degli stessi;
+      \item[-] \textbf{Configuration Settings:} pagina principale del pannello di amministrazione dove possiamo modificare le impostazioni base del Wiki come la lingua, il tema e le opzioni associate, la licenza, le impostazioni di visualizzazione e di autenticazione;
+      \item[-] \textbf{Revert Manager:} permette di ripristinare le pagine a seguito di un possibile attacco di spam che le ha alterate; 
+      \item[-] \textbf{Popularity Feedback:} permette di mandare informazioni sul proprio wiki agli sviluppatori in modo che possano meglio decidere quali politiche di sviluppo adottare per le successive versioni del software.
+\end{itemize}
+Per prima cosa andiamo su \textit{Configuration Setting} e alla voce \textit{Interface Language} scegliamo dal menu a tendina l'opzione \textit{it}, andiamo in fondo alla pagina e facciamo click su \textit{Save}, avremo quindi tutto il nostro wiki automaticamente tradotto in
+Italiano.
+
+\subsubsection*{Cambiare il tema}
+Dokuwiki può essere personalizzato andando ad installare diversi temi, alcuni di questi lo rendono più simile ad un blog altri invece lo fanno somigliare al tema di Wikipedia. Tutti i temi sono disponibili all'indirizzo \url{http://www.dokuwiki.org/Template} nel nostro caso scaricheremo il tema monobook, praticamente identico al vecchio tema di Wikipedia. Il file da scaricare sarà \tx{2010-08-17\_monobook.tar.gz}. Scompattiamolo con il comando
+\begin{lstlisting}
+tar -zxf 2010-08-17_monobook.tar.gz
+\end{lstlisting}
+e verrà creata la cartella \tx{monobook}. Per installare il tema è sufficiente copiarlo nella cartella \tx{lib/tpl/} di Dokuwiki con il comando
+\begin{lstlisting}
+sudo cp -R monobook/ /var/www/html/dokuwiki/lib/tpl/
+\end{lstlisting}
+A questo punto andiamo nel pannello di amministrazione e clicchiamo su \textit{Configurazione Wiki}, alla voce \textit{Template} nel menu a tendina scegliamo \textit{Monobook} e a fondo pagina clicchiamo su Save.
+
+\subsubsection*{Installazione plugin}
+I Plugin in Dokuwiki, così come in tutti i programmi, consentono di ampliare le funzionalità messe a disposizione dal wiki. I plugin messi a disposizione per Dokuwiki su possono scaricare alla pagina \url{http://www.dokuwiki.org/plugins}. Nel nostro esempio scaricheremo i plugin:
+\begin{itemize}
+      \item[-] \textbf{Note:} Permette di inserire delle note colorate all'interno del Wiki per far risaltare alcune informazioni importanti come la lettura della licenza o le indicazioni sulla formattazione delle pagine.\\ \url{http://www.dokuwiki.org/plugin:note}
+      \item[-] \textbf{Code2:} Permette di inserire del codice sorgente nella vostra pagina in modo che le parole chiave del linguaggio siano evidenziate, per fare ciò si appoggia all'evidenziatore di sintassi per il web: GeSHi. \\ \url{http://www.dokuwiki.org/plugin:code2}
+\end{itemize}
+Per installare un plugin basta scaricare il suo archivio, che nel nostro caso corrispondono a \tx{dokuwiki-note-20090615.tgz} e \tx{syntax\_plugin\_code.zip}, scompattarli
+\begin{lstlisting}
+tar -zxf dokuwiki-note-20090615.tgz
+unzip syntax_plugin_code.zip
+\end{lstlisting}
+e copiarli nella cartella \tx{lib/plugins/} di Dokuwiki con il comando
+\begin{lstlisting}
+sudo cp -R code/  /var/www/html/dokuwiki/lib/plugins/
+sudo cp -R note/  /var/www/html/dokuwiki/lib/plugins/
+\end{lstlisting}
+Maggiori informazioni sui plugin possono essere trovate andando nel pannello di amministrazione alla voce \textit{Gestione Plugin} dove si troveranno informazioni sulle versioni installate, il collegamento alla pagina ufficiale per la documentazione e tanto altro.
+
+\vspace{.5cm}\noindent Documento rilasciato con licenza CC BY-SA 3.0, maggiori informazioni alla pagina web:\\ \url{http://creativecommons.org/licenses/by-sa/3.0/deed.it}
+\end{document}
diff --git a/pool/DokuWiki/dokuwiki_1.txt b/pool/DokuWiki/dokuwiki_1.txt
new file mode 100644
index 0000000..0ff646b
--- /dev/null
+++ b/pool/DokuWiki/dokuwiki_1.txt
@@ -0,0 +1,21 @@
+Sección: Tutoriales.
+
+Explorando DokuWiki (parte 1).
+
+Características de DokuWiki
+
+Usos de dokuwiki
+
+Instalación
+
+Lighttpd
+
+(puede ser apache, pero es pesado para netbooks y procesadores menos recientes)
+
+DokuWiki desde fuentes
+
+(el empaquetado en Fedora depende de Apache)
+
+--Aquí tomaré principalmente el howto de Alberto Bonacina
+(embajador de Fedora italiano), a su disposición en dokuwiki.tex--
+
diff --git a/pool/historial_bash b/pool/historial_bash
new file mode 100644
index 0000000..e006122
--- /dev/null
+++ b/pool/historial_bash
@@ -0,0 +1,10 @@
+Sección: COMOs de Bash
+
+* Acortar url's desde la terminal (introducción a sed).
+
+
+* Optimizar el uso del historial.
+
+
+* Bonus: Conociendo <devtodo>
+




Más información sobre la lista de distribución revista-fedora-latam