Instalar ikiwiki

ver: http://ikiwiki.info/setup/ y http://ikiwiki.info/tips/dot_cgi/

instalar ikiwiki de los repositorios

 apt-get install ikiwiki

crear una instancia de ikiwiki

 ikiwiki --setup /etc/ikiwiki/auto.setup

pregunta el entre otros datos y crea los archivos en el directorio del usuario!

mover los archivos (ej: /opt/ikiwiki y /var/www)

config file

 mv /<carpeta_usuario>/<nombre_wiki>.setup /opt/ikiwiki

static files

 mv /<carpeta_usuario>/public_html/<nombre_wiki> /var/www/<nombre_wiki> 

ikiwiki repo

 mv /<carpeta_usuario>/<nombre_wiki>.git /opt/ikiwiki/<nombre_wiki>.git

borrar el ikiwiki src (el que contiene los archivos .md fuente)

 rm -r /<carpeta_usuario>/<nombre_wiki>

clonar el src de la nueva localizacion del repo

 cd /opt/ikiwiki
 git clone /opt/ikiwiki/<nombre_wiki>.git

se creará /opt/ikiwiki/<nombre_wiki>

setup wiki

editar .setup cambiando las nuevas direcciones y luego

 ikiwiki --verbose --setup <nombre_wiki>.setup

configurar apache

editar /etc/apache2/apache2.conf y agregar al final

 AddHandler cgi-script .cgi

luego agregar un virtualhost, por ejemplo /etc/apache2/sites-enabled/000-default

 <VirtualHost *:80>
     ServerName sitio.org
     ServerAlias www.sitio.org

     DocumentRoot /var/www/<nombre_wiki>
     ErrorLog ${APACHE_LOG_DIR}/<nombre_wiki>-error.log
     LogLevel warn
     CustomLog ${APACHE_LOG_DIR}/<nombre_wiki>-access.log combined

     AddHandler cgi-script .cgi
     Options FollowSymLinks +ExecCGI
 </VirtualHost>

reiniciar apache

 /etc/init.d/apache2 restart

voila!

Resetear password

ver https://ikiwiki.info/tips/inside_dot_ikiwiki/discussion/

para desactivar nuevas cuentas

http://ikiwiki.info/forum/Disable_account_creation_for_new_users/#comment-d9a464cd90e1b8f807b6979673a3a3a5

Activar Multimarkdown

Para activarlo modificar en wiki.setup

# mdwn plugin
# enable multimarkdown features?
multimarkdown => 1,

para instalar text::multimarkdown via cpan

 apt-get install build-essential cpanminus
 cpanm Text::MultiMarkdown

Por un bug de ikiwiki las notas al pie no funcionan correctamente si no se desinstala htmlscrubber

# plugins to disable
disable_plugins => [qw{openid htmlscrubber}],

Ejecutar ikiwiki para reconstruir el sitio

ikiwiki --verbose --setup <nombre_wiki>.setup

Links: * Text-MultiMarkdown en CPAN * MultiMarkdown * Referencia de sintaxsis MultiMarkdown

custom highlight

(dirty mode) modificando _DoItalicsAndBold en usr/share/perl5/Text/Markdown

    sub _DoItalicsAndBold {
        my ($self, $text) = @_;

        # Handle at beginning of lines:
        $text =~ s{ ^(\*\*|__) (?=\S) (.+?[*_]*) (?<=\S) \1 }
            {<strong>$2</strong>}gsx;

    +   $text =~ s{ ^(\@\@) (?=\S) (.+?[@]*) (?<=\S) \1 }
    +       {<span class="custom-highlight">$2</span>}gsx;

        $text =~ s{ ^(\*|_) (?=\S) (.+?) (?<=\S) \1 }
            {<em>$2</em>}gsx;

        # <strong> must go first:
        $text =~ s{ (?<=\W) (\*\*|__) (?=\S) (.+?[*_]*) (?<=\S) \1 }
            {<strong>$2</strong>}gsx;

    +   $text =~ s{ (?<=\W) (\@\@) (?=\S) (.+?[@]*) (?<=\S) \1 }
    +       {<span class="custom-highlight">$2</span>}gsx;

        $text =~ s{ (?<=\W) (\*|_) (?=\S) (.+?) (?<=\S) \1 }
            {<em>$2</em>}gsx;
        # And now, a second pass to catch nested strong and emphasis special cases
        $text =~ s{ (?<=\W) (\*\*|__) (?=\S) (.+?[*_]*) (?<=\S) \1 }
            {<strong>$2</strong>}gsx;

        $text =~ s{ (?<=\W) (\*|_) (?=\S) (.+?) (?<=\S) \1 }
            {<em>$2</em>}gsx;

        return $text;
     }

ikiwikis distribuidos

notas para "laptop wiki with git":

clonar desde el repositorio remoto src.git usando git en la carpeta local donde se ubicara ikiwiki:

git clone ssh://user@server.com:<puerto>/ruta/miwiki/src.git /ruta/local/miwiki/src

uso de rsync para copiar carpetas remotas de la instancia ikiwiki:

# crear directorio y copiar (es decir, la primera vez)
rsync -avz --rsh 'ssh -p<puerto>' user@server.com:/ruta/miwiki/templates /ruta/local/miwiki/

# actualizar un directorio (ojo '/' final)
rsync -avz --rsh 'ssh -p<puerto>' user@server.com:/ruta/miwiki/templates/ /ruta/local/miwiki/templates/

más tips

  • seguir las instrucciones de laptop wiki with git
  • el plugin highlight se instala aparte, buscarlo en apt-get: libhighlight-perl
  • el plugin multimarkdown se instala aparte, en apt-get: libtext-multimarkdown-perl (verificar esto)
  • si gitorigin_branch: no funciona probar con gitorigin_branch => '',
  • antes de correr ikiwiki -setup miwiki.setup -getctime, asegurarse de que las rutas a /var/www/miwiki... y urls (ej: http://miwiki.localhost) estén bien configuradas
  • se debe crear el usuario admin con la clave para crear nuevos usuarios que esta en miwiki.setup account_creation_password => ...

uso:

  • luego de usar git en el sistema local para traer cambios (git pull) desde el servidor, se necesita ikiwiki -setup /ruta/a/wiki.setup para actualizar el wiki local, en cambio cuando se pushea un cambio hacia el servidor, este actualiza automáticamente

ver además:

http://ikiwiki.info/templates/ http://ikiwiki.info/themes/

lindo tema: https://github.com/AntPortal/ikiwiked

!Bootstrap para ikiwiki

ver -> https://github.com/kheops2713/words.ceops.eu/blob/master/posts/Improving%20Ikiwiki%20style%20with%20Bootstrap.mdwn


http://library.linode.com/web-applications/wikis/ikiwiki/ubuntu-10.04-lucid http://www.deferredprocrastination.co.uk/blog/2011/getting-started-with-ikiwiki-part-1/