revista-fedora-latam February 2011

revista-fedora-latam@lists.fedorahosted.org

1 participants
9 discussions

pool/DokuWiki pool/historial_bash
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 25 Feb '11

25 Feb '11

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(a)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@plain\ps@empty +\ps@empty +\makeatother + +\begin{document} +\begin{center} +\begin{huge} +Installazione Dokuwiki\\ +\end{huge} +\begin{Large} +Bonacina Alberto\\ +\mail{bonacina.alberto(a)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> +

1 0

website/experimental
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 10 Feb '11

10 Feb '11

website/experimental | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) New commits: commit f167b4ef03da2f41149933fe107ec4a4423419a5 Author: Jesús E. Franco Martínez <tezcatl(a)riseup.net> Date: Thu Feb 10 03:09:41 2011 -0600 Corrigiendo/ampliando instrucciones para rama experimental diff --git a/website/experimental b/website/experimental index 9abb11a..19c1b24 100644 --- a/website/experimental +++ b/website/experimental @@ -2,9 +2,29 @@ Aquí vamos a ir colocando algunos recursos que nos servirán para explorar ideas para un sitio web con herramientas integradas a git. Para ver los contenidos en fase experimental -puedes intentar: +por primera vez) ejecuta: -git checkout -b web-experimental +git checkout -b web-experimental --track origin/web-experimental + +Luego, para volver a la versión de producción, con +el flujo de trabajo normal, sólo corre: + +git checkout master + +Después de que hayas trabajado en el artículo, +maquetado, pulido en general, y enviado tus cambios +con git add . && git commit && git push +puedes volver a trabajar con los contenidos +experimentales con + +git checkout web-experimental + +Ya no son necesarias las demás opciones, puesto +que la primera vez ya ligaste tú rama web-experimental +con origin/web-experimental (la común). + +Cualquier duda, pregunta, nosotros vamos aprendiendo +también. Happy hacking!!

1 0

Changes to 'refs/remotes/origin/master'
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 10 Feb '11

10 Feb '11

1 0

Changes to 'web-experimental'
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 10 Feb '11

10 Feb '11

New branch 'web-experimental' available with the following commits: commit 101ff200f7042cd2d204ed08a2cb8f4041c12fbb Author: Jesús E. Franco Martínez <tezcatl(a)riseup.net> Date: Thu Feb 10 02:38:34 2011 -0600 Creada rama experimental para hackear el tema de publican-fedora

1 0

Changes to 'refs/remotes/origin/HEAD'
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 10 Feb '11

10 Feb '11

1 0

Branch 'refs/remotes/github/HEAD' - 0 commits -
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 10 Feb '11

10 Feb '11

Rebased ref, commits from common ancestor:

1 0

Branch 'refs/remotes/github/master' - 0 commits -
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 10 Feb '11

10 Feb '11

Rebased ref, commits from common ancestor:

1 0

README website/experimental
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 10 Feb '11

10 Feb '11

README | 3 +++ website/experimental | 11 +++++++++++ 2 files changed, 14 insertions(+) New commits: commit 7c2f0220fc9f1056c8af6690ac73afdcc19ade1d Author: Jesús E. Franco Martínez <tezcatl(a)riseup.net> Date: Thu Feb 10 02:28:32 2011 -0600 Instrucciones para rama experimental en websites diff --git a/README b/README index 57060db..dfa27d7 100644 --- a/README +++ b/README @@ -13,5 +13,8 @@ O clona este repositorio con permisos de sólo lectura: $ git clone git://git.fedorahosted.org/git/revista-fedora-latam.git Puedes comenzar a trabajar en el repositorio en lo que aprobamos tu solicitud. +Pregunta en la lista de correos acerca de como enviar tus contribuciones +si ya estás trabajando en el repositorio, pero no has aplicado aún al +grupo en FAS. Mil gracias por tu interés. diff --git a/website/experimental b/website/experimental new file mode 100644 index 0000000..9abb11a --- /dev/null +++ b/website/experimental @@ -0,0 +1,11 @@ +Aquí vamos a ir colocando algunos recursos +que nos servirán para explorar ideas para +un sitio web con herramientas integradas a +git. Para ver los contenidos en fase experimental +puedes intentar: + +git checkout -b web-experimental + +Happy hacking!! + +~tzk

1 0

pool/freed-ora
by Lista auxiliar de coordinación de colaboradores de la Revista Fedora Latinoamérica 02 Feb '11

02 Feb '11

pool/freed-ora | 3 +++ 1 file changed, 3 insertions(+) New commits: commit 24e1167fe82250969dc58cbdfe4cb59f52ed1fbb Author: Jesús E. Franco Martínez <tezcatl(a)riseup.net> Date: Wed Feb 2 16:33:18 2011 -0600 Commit de ejemplo para el Taller de Git en #fedora-classroom diff --git a/pool/freed-ora b/pool/freed-ora new file mode 100644 index 0000000..730ee87 --- /dev/null +++ b/pool/freed-ora @@ -0,0 +1,3 @@ +i + +

1 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

revista-fedora-latam February 2011