<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website Full V2.4.0//EN" "http://docbook.sourceforge.net/release/website/2.4.0/schema/dtd/website-full.dtd">
<!--
      Este fichero es parte de la página web de AsturLiNUX. Las condiciones
      de utilización están sujetas a la misma licencia que la página web.
      Consulte la página web http://www.asturlinux.org/licencia.php para
      más detalles.
    -->
<!-- $Id: index.xml 857 2006-03-11 09:20:37Z wikier $ -->
<webpage lang="es" id="actividades.proyectos.web.indice">
  <config param="rcsdate" value="$Date: 2006-03-11 10:20:37 +0100 (sÃ¡b, 11 mar 2006) $"/>

  <head>
    <title>Mantenimiento de la web de AsturLiNUX</title>
  </head>

  <para>
    La página web de AsturLiNUX contiene mucha información en
    múltiples apartados, y su mantenimiento es una tarea no
    trivial, realizada por varios
    <foreignphrase>webmasters</foreignphrase>. En esta página
    trataremos de dar información sobre cómo se organiza y construye
    la página.
  </para>

  <para>
    Algunas de las tecnologías utilizadas son:
  </para>

  <itemizedlist>
    
    <listitem>
      <para><emphasis><literal>XML</literal></emphasis> para
	representar el contenido,
	utilizando los <literal>DTD</literal> de <productname>DocBook
	  WebSite</productname>.</para>
    </listitem>

    <listitem>
      <para><emphasis><literal>XSLT</literal></emphasis> para
	transformar el contenido a otros formatos, concretamente
	<literal>XHTML</literal> para la web, pero también
	<literal>HTML</literal>, texto plano o
	<literal>PDF</literal>.</para>
    </listitem>
    
    <listitem>
      <para><emphasis><literal>SVN</literal></emphasis> para gestionar
	el contenido.</para>
    </listitem>

    <listitem>
      <para><emphasis><literal>PHP</literal></emphasis> para la parte
	dinámica, aunque se
	trata de minimizar el uso de <literal>PHP</literal> en favor
	de las transformaciones <literal>XSLT</literal>.</para>
    </listitem>

    <listitem>
      <para><emphasis><literal>XHTML</literal></emphasis> como formato
	de las páginas web.</para>
    </listitem>

    <listitem>
      <para><emphasis><literal>CSS</literal></emphasis> para formatear
	las páginas.</para>
    </listitem>
    
  </itemizedlist>

  <section>
    <title>Contenidos del proyecto</title>

    <para>
      Los siguientes documentos describen el funcionamiento de la
      infraestructura creada para estas páginas web:
    </para>

    <itemizedlist>
      
      <listitem>
	<para>
	  <olink targetdoc="actividades.proyectos.web.organizacion-svn" targetptr="actividades.proyectos.web.organizacion-svn">
            Organización de los
	    ficheros en el <literal>SVN</literal>
          </olink>:
          describe los ficheros que se
	  pueden encontrar en el <literal>SVN</literal> y qué función
	  tiene cada uno.
	</para>
      </listitem>

      <listitem>
	<para>
	  <olink targetdoc="actividades.proyectos.web.modelo-publicacion" targetptr="actividades.proyectos.web.modelo-publicacion">
            Modelo de publicación
          </olink>:
          describe el proceso por el cual se
	  generan las páginas, y las instrucciones para reproducirlo.
	</para>
      </listitem>

      <listitem>
	<para>
	  <olink targetdoc="actividades.proyectos.web.publicar-una-pagina" targetptr="actividades.proyectos.web.publicar-una-pagina">
            Cómo publicar una página
          </olink>:
          guía rápida para añadir una nueva página a la web.
	</para>
      </listitem>

    </itemizedlist>

    <para>
      También está disponible una <ulink>página del wiki</ulink> para
      preparar la ponencia que se presenta a las
      <olink targetdoc="jornadas.2005.indice" targetptr="jornadas.2005.indice">
        V Jornadas de
	<foreignphrase>Software</foreignphrase> Libre en
	Asturias
      </olink>.
    </para>

  </section>

  <section>
    <title><foreignphrase>Software</foreignphrase> necesario</title>

    <para>
      El desarrollo de este proyecto se realiza sobre sistemas Debian
      Sarge y Sid. Estos son los paquetes necesarios para procesar
      la web:
    </para>

    <itemizedlist>
      <listitem>
	<para><emphasis>docbook-website</emphasis> (versión
          2.5.0).</para>
      </listitem>
      <listitem>
	<para><emphasis>docbook-xsl</emphasis> (versión 1.66).</para>
      </listitem>
      <listitem>
	<para><emphasis>docbook-xml</emphasis> (versión 4.3).</para>
      </listitem>
      <listitem>
	<para><emphasis>w3c-dtd-xhtml</emphasis> (recomendado).</para>
      </listitem>
      <listitem>
	<para><emphasis>libxml2</emphasis> (versión 2.6.11).</para>
      </listitem>
      <listitem>
	<para><emphasis>libxslt1.1</emphasis> (versión 1.1.8). No
          obstante, véase <ulink>este
          bug</ulink>.</para>
      </listitem>
    </itemizedlist>

  </section>

  <section>
    <title>Enlaces</title>

    <para>
      Las siguientes webs contienen información de referencia sobre
      las tecnologías empleadas en la construcción de la web:
    </para>

    <itemizedlist>

      <listitem>
	<para>
	  Sobre XML:
	</para>

	<itemizedlist>
	  <listitem>
	    <para>
	      <ulink>Página sobre XML en
		el W3C</ulink> (sus creadores).
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem> <!-- Sobre XML -->
      
      <listitem>
	<para>
	  Sobre XSLT:
	</para>

	<itemizedlist>
	  <listitem>
	    <para>
	      <ulink>Especificación de
		XSLT en el W3C</ulink>.
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem> <!-- Sobre XSLT -->
      
      <listitem>
	<para>Sobre DocBook XML:</para>

	<itemizedlist>

	  <listitem>
	    <para>
	      <ulink>Comité de
		estandarización de DocBook XML</ulink> (dependiente de
	      OASIS).
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <ulink>Proyecto
		DocBook</ulink> en SourceForge, desde donde se puede
	      bajar el <foreignphrase>software</foreignphrase>.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <ulink>FAQ de
		DocBook</ulink>.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <ulink>DocBook: the definitive guide</ulink>: el libro de referencia imprescindible sobre DocBook, que explica el significado de cada etiqueta.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <ulink>DocBook XSL: the complete guide</ulink>: complemento del anterior, describe las hojas de transformación que transforman los documentos DocBook, y cómo personalizarlas. Contiene un capítulo sobre DocBook Website.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <ulink>Guide
		to the DocBook DTD</ulink>: conjunto de cuatro
	      documentos que ayudan a conocer las etiquetas
	      disponibles en DocBook.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <ulink>DocBook XSL Stylesheet Reference Documentation</ulink>: describe los parámetros que se pueden utilizar para configurar las hojas XSL de Norman Walsh.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <ulink>DocBook Website</ulink>: una especialización de DocBook para generar páginas web.
	    </para>
	  </listitem>

	</itemizedlist>

      </listitem> <!-- Sobre DocBook XML -->

      <listitem>
	<para>Sobre XHTML:</para>

	<itemizedlist>

	  <listitem>
	    <para>
	      <ulink>Especificación
		del XHTML</ulink> en el W3C.
	    </para>
	  </listitem>

	</itemizedlist>

      </listitem> <!-- Sobre XHTML -->

      <listitem>
	<para>Sobre CSS:</para>

	<itemizedlist>

	  <listitem>
	    <para>
	      <ulink>Página sobre
		CSS en el W3C</ulink>, sus creadores.
	    </para>
	  </listitem>

	  <listitem>
	    <para>
	      <ulink>A List
		Apart</ulink>, una web llena de trucos y artículos
	      sobre CSS.
	    </para>
	  </listitem>

	</itemizedlist>

      </listitem> <!-- Sobre CSS -->

      <listitem>
	<para>Varios:</para>

	<itemizedlist>
	  <listitem>
	    <para>
	      <ulink>Hojas de referencia rápida</ulink> (chuletas) sobre varias de las tecnologías utilizadas.
	    </para>
	  </listitem>
	</itemizedlist>

      </listitem> <!-- Varios -->

    </itemizedlist>

    <para>
      Un documento interesante que describe una alternativa similar a
      la implementada en esta web se puede encontrar en la página de
      <ulink>Jose
	Fonseca</ulink>.
    </para>

  </section> <!-- Enlaces -->


  <section>
    <title>Más información</title>

    <para>
      Para ampliar la información, puedes contactar con el
      <foreignphrase>webmaster</foreignphrase>, cuya dirección
      aparece en la
      <olink targetdoc="asociacion.contacto" targetptr="asociacion.contacto">
        sección de contacto
      </olink>.
    </para>

  </section>
  
</webpage>
