sintaxis de dokuwiki...

Solicite, consulte o publique recursos de referencia para desarrolladores.

sintaxis de dokuwiki...

Notapor Dokan » Vie Dic 07, 2007 6:01 pm

A futuro

Crear una página que explique la sintaxis de dokuwiki.


Estaba editando en el wiki para ampliar un poquillo la sección 'index' de pygame hasta que he visto que necesito una referencia para darle formato al tema y lo he dejado... (la verdad es q me han llamado para salir a cenar :P ).
Quería darle una distribución lo más parecida a la web de pygame pero no se como se vincula en el wiki lo que en html se hace así:
<a name="pygame.init">
y luego para referenciarlo desde otro punto de la web:
<a href="pygame.html#pygame.init">

Quien sepa la sintaxis de docuwiki que tire la primera piedra...

Por otro lado, leyendo el código fuente de la documentación de la web de pygame (en firefox para ver el código fuente haz CTRL+U) se me ha ocurrido que para conservar una relación de distribución lo más parecida posible con la web original en inglés podríamos literalmente copiar el formato desde <html> hasta </html> obviando JS y CSS, y solo traducir los textos. ¿Para qué reinventar la rueda?
Dejen su opinión al salir...
De todos modos más información sobre la sintaxis de docuwiki es imprescindible para que éste crezca con esta y otras documentaciones y/o traducciones.
Avatar de Usuario
Dokan
 
Mensajes: 143
Registrado: Lun Dic 03, 2007 10:40 pm

Re: sintaxis de dokuwiki...

Notapor hugoruscitti » Vie Dic 07, 2007 7:30 pm

Dokan escribió:Quería darle una distribución lo más parecida a la web de pygame pero no se como se vincula en el wiki lo que en html se hace así:
<a name="pygame.init">
y luego para referenciarlo desde otro punto de la web:
<a href="pygame.html#pygame.init">

Quien sepa la sintaxis de docuwiki que tire la primera piedra...


Saludos, las referencias a secciones internas en dokuwiki se realizan
de manera muy similar a HTML. Tienes que colocar un numeral (#)
seguido de la sección interna dentro del vínculo:

Código: Seleccionar todo
Este es un vinculo a la sección [[pygame:pygame#init | dos]]


Puedes ver un ejemplo aquí:

http://www.losersjuegos.com.ar/dev/doku ... playground

O en un tutorial de dokuwiki:

http://mundogeek.net/wiki/doku.php?id=w ... x#internal

Es interesante ver que el mismo motor de dokuwiki se encarga de colocar
la referencia (<a name="..."/>) a cada título. De forma que te resultará
mucho mas sencillo que hacerlo en HTML.

Dokan escribió:Por otro lado, leyendo el código fuente de la documentación de la web de pygame (en firefox para ver el código fuente haz CTRL+U) se me ha ocurrido que para conservar una relación de distribución lo más parecida posible con la web original en inglés podríamos literalmente copiar el formato desde <html> hasta </html> obviando JS y CSS, y solo traducir los textos. ¿Para qué reinventar la rueda?
Dejen su opinión al salir...


Hay muy pocos proyectos de traducción que trabajan traduciendo texto dentro
de elementos HTML. Creo que utilizar un wiki es mas adecuado, porque contamos
con un control de versiones, por cada cambio queda registrado el nombre de
quien lo realiza y con ello se reconoce el crédito de haber ayudado, no tenemos
problemas de versiones y se puede modificar con facilidad.
De otra forma, con HTML resultaría mas complejo y generaría menos participación.

Creo que el wiki se tornará mas interesante en la medida que empecemos a
utilizarlo mas, este verano me gustaría mucho mejorar la integración del wiki
a la web.

A medida que lo utilicemos, vamos a ir mejorando nuestra forma de participar.
Por dar un ejemplo, existe un complemento para Firefox que te
permite utilizar el editor de textos que mas te guste para editar el wiki;
personalmente me siento mucho mas cómodo escribiendo texto en VIM con
resaltado de sintaxis:

Imagen

el complemento se llama "It's all text":

https://addons.mozilla.org/es-ES/firefox/addon/4125

y los archivos necesarios para el resaltado de sintaxis está en:

http://www.chimeric.de/projects/dokuwiki/vimsyntax

también existe un complemento que muestra errores de ortografía en el mismo
navegador:

Imagen


Dokan escribió:De todos modos más información sobre la sintaxis de docuwiki es imprescindible para que éste crezca con esta y otras documentaciones y/o traducciones.


Sí, es cierto. Con el tiempo lo iremos realizando, es una buena idea.

Saludos.
Avatar de Usuario
hugoruscitti
Site Admin
 
Mensajes: 1242
Registrado: Dom Jul 30, 2006 3:57 am
Ubicación: Buenos Aires, Argentina

Notapor Dokan » Sab Dic 08, 2007 12:56 am

ooops!
Gracias!!
Creo q con el tutorial del dokuwiki ya tengo para entretenerme de momento. A ver si le pillo el truco.

EDIT

pues creo q más o menos empieza a parecer algo, echad un vistazo al índice de pygame.

una duda que tengo es si ponemos los módulos base de pygame en esta página del docuwiki y dejamos el índice como referencia o si hacemos otra página para los siete modulos base de pygame (así está en pygame.org).
Avatar de Usuario
Dokan
 
Mensajes: 143
Registrado: Lun Dic 03, 2007 10:40 pm

Notapor ominae » Sab Dic 08, 2007 12:30 pm

Dokan escribió:pues creo q más o menos empieza a parecer algo, echad un vistazo al índice de pygame.

Muy bien! No creas que necesitas tutoriales muy avanzados para editar el wiki, yo me aclaré mirando el código de Hugo... En realidad es poco lo que has de aprender!
Dokan escribió:una duda que tengo es si ponemos los módulos base de pygame en esta página del docuwiki y dejamos el índice como referencia o si hacemos otra página para los siete modulos base de pygame (así está en pygame.org).

Creo que me gusta más como está ahora, la documentación de pygame original me resulta algo caótica... :wink:

Un saludo!
Jaime Forcada Balaguer
ominae
 
Mensajes: 19
Registrado: Mar Ago 22, 2006 11:17 am

Notapor Dokan » Sab Dic 08, 2007 8:40 pm

es q nunca habia editado un wiki, y siempre pensé que sería con formato html, por eso me ofusqué un poco, pero ahora ya está todo más claro.
de momento he ampliado un poco (poco) el index y he añadido la página de funciones locales de pygame.
como pediste la portada la dejé como estaba, sólo he añadido un vinculo a la nueva página.
a partir de ahora irá todo más rodado :)
Avatar de Usuario
Dokan
 
Mensajes: 143
Registrado: Lun Dic 03, 2007 10:40 pm

Notapor hugoruscitti » Mar Dic 11, 2007 6:27 pm

Dokan escribió:una duda que tengo es si ponemos los módulos base de pygame en esta página del docuwiki y dejamos el índice como referencia o si hacemos otra página para los siete modulos base de pygame (así está en pygame.org).


Personalmente prefiero un índice de contenidos que solo enumere los
módulos principales. Algo como:

* image - descripción
* sprite - descripción
* etc.

creo que de esta forma es mas sencillo acceder al contenido de la
biblioteca.

Luego, si queremos mostrar todas las funciones y módulos en una
sola página, porque algunos usuarios lo prefieren así, podemos
generar un listado de la biblioteca de forma automática.

Vean el código de la siguiente página:

http://www.losersjuegos.com.ar/dev/doku.php/playground/playground

Es esa página se muestra un índice de contenidos completo;
lo interesante es que se construye y actualiza de manera
automática, leyendo cada una de las secciones y mostrando
los titulares mas importantes. El complemento que permite
realizar esta tarea se llama nstoc, y pueden encontrar
mas información de él en la siguiente dirección:

http://wiki.splitbrain.org/plugin:nstoc

Tengo que hacer algunas modificaciones para que se 'vea' mejor,
pero la idea es la misma: hacer un listado completo de forma
automática.

Este complemento también lo podemos utilizar para generar un
mapa del sitio web completo.

Saludos
Avatar de Usuario
hugoruscitti
Site Admin
 
Mensajes: 1242
Registrado: Dom Jul 30, 2006 3:57 am
Ubicación: Buenos Aires, Argentina

Notapor Dokan » Mar Dic 11, 2007 8:09 pm

pues yo ya estaba traduciendo el índice de contenidos de pygame, porque me oriento mejor, de un vistazo encuentro lo que busco (¡¡aunque luego no me aclaro de como funciona!! :cry: ).
pero veo que ya no hace falta traducirlo, así ahorramos trabajo, así que seguiré por otro lado a partir del próximo día.
para la versión definitiva del indexado hay que poner una breve descripción de cada sección junto al nombre, que para pygame.display no hace falta, pero por ejemplo para métodos más concretos siempre viene bien tener una pequeña referencia.
Avatar de Usuario
Dokan
 
Mensajes: 143
Registrado: Lun Dic 03, 2007 10:40 pm


Volver a Artículos, traducciones y documentación

¿Quién está conectado?

Usuarios navegando por este Foro: No hay usuarios registrados visitando el Foro y 2 invitados