                                    

   = Trucos para editar un documento o Una Otra Lenguaje Wiki


* Introduccin

  Esta pgina intenta dar informacin acerca maneras para mejorar
  los documentos que escribes usando este sistema. Hay un nmero
  de trucos o maneras para formatear tus documentos que permite
  que parecen mejores cuando estn trasducidos a pginas web.
  La idea es evitar el uso de HTML y tambien evitar la necesidad
  de saber lenguajes tcnicas para elaborar pginas web.

* Ejemplos

  Para empezar, muchas cosas son formateadas sin que tienes que hacer
  nada. Por ejemplo, si el sistema vea algo que suena como un
  URL o un referencia a una otra pgina web, automaticamente 
  este pieza de texto es transformado en un hyper enlace en 
  la pgina web.
  Unos ejemplos

    a- >www.geocities.com resulta www.geocities.com
     - >http://www.geocities.com tambien resulta en http://www.geocities.com
     - >link:///refurb/docs/ resulta en link:///refurb/docs 
       Aqu puedes notar que hay algo extrao sucedendo. Si conozes un poco
       de URLs y HTML quizs sabes que no hay ningun protcolo que tiene
       el texto link://. Es un protcolo inventado (por yo) que est
       diseado a hacer referencias a ficheros locales. 
     - >"Texto".www.geocities.com resulta en 
        "Texto" www.geocities.com (pero con espacios no puntos)
        
  

  So the language rules only need to be learnt if you want to use 
  'special' features, like making section headings that get automatically
  put into tables of contents, or making lists which are numbered with
  numerals or with alphabetical characters.

  Tambien ver el 'faq' link:///refurb/docs/system-faq.html
  y el 'documento index' link:///refurb/docs/documents.html
  Puedes "editar esta pgina" [self-edit-link]

* Seccines y Titulos y Tablas de Contenidas

  El ttulo principal del documento es sealado por el carcter =
  que debe parecer como la primera carcter de la linea.
  
  Tu puedes utilizar ttulos de secciones para organizar tu 
  documento, y para disfrutar del punto de sistema que automaticamente
  hace una tabla de contenidas usando los ttulos de secciones.
  Estas tables de contenidas son hyperenlazadas para que tu puedas
  navegar sencillamente dentro del documento. 

  Ahora la carcter que introduzca un ttulo de seccin es * pero
  por el pasado fue un diferente patron, es a decir, todos
  mayusculas por la linea de texto. Tengo un prefencia por el
  patrn de todas mayusculas pero no he escrito los codigos PHP por
  esto todava.


* Listas

  Tu puedes aconseguir a hacer listas de cosas utilizando un
  formato muy sencillo que es:
  -->>
     a- Vamos al supermecado
      - Vamos a comprar cosas que no necesitamos
      - Vamos a sentir feliz
      - Vamos a beber alcool
  --<<
  Cuando guardas tus cambios y abres la pgina web en un navegador
  debes ver algo como lo siguiente
  
     a- Vamos al supermecado
      - Vamos a comprar cosas que no necesitamos
      - Vamos a sentir feliz
      - Vamos a beber alcool

  Una linea de texto que est vacia termina la lista. Cada punto
  de la lista necesita un carcter - Para hacer una lista no
  ordenado, utiliza u- en lugar de a- Para hacer una lista 
  que est numerado, utiliza 1- Paraa hacer una lista que no tiene 
  ningun diacrisis o ningun smbolo para marcar las unidades, utiliza  u--
  (es a decir, doble --)


* Enlaces automticas

  Texto por el documento que suena como un URL es automaticamente
  hyerenlazado. Por ejemplo
  -->> http://wagga-cwc.org.au --<<
  est traducido a  http://wagga-cwc.org.au 

  O puedes teclar
  -->>
    "The Mission Australia Work Center" http://wagga-cwc.org.au  or
    'The Mission Australia Work Center' http://wagga-cwc.org.au  
  --<<
  y va a parecer como "The Mission Australia Work Center" 
  http://wagga-cwc.org.au 

  Para vincular a un fichero local (por el mismo servidor donde 
  el documento que ests editando est ubicado), puedes usar el
  protcolo falso link://

  Por ejemplo -->> link:///refurb/  --<<
  y tambien   -->> 'The pc recycle site' link:///refurb/ --<<
  debe resultar respectivamente en link:///refurb/ y  
  'The pc recycle site' link:///refurb/  

  Todos esos tipos de maneras de hacer enlaces pueden ser 
  modificados poniendo un smbolo de exclamacin (exclamation mark)
  en frente del URL o de pseudo URL. Eso tieno el efecto de hacer
  el blanco abrir en una nueva ventana de tu navegador. 

  Por ejemplo -->> 'Vamos a casa' !link:/// --<<
  debe resultar en 'Vamos a casa' !http://wagga-cwc.org.au

  Un otro truco es encerrar el URL por las caracteres []
  asi -->> [.http://wagga-cwc.org.au] --<< (sin el primero punto)
  que debe salir como [http://wagga-cwc.org.au]

* Otros Patrones

  En ingls si teclas algo como 
  -->> press the enter key --<< debe resultar en un botn falso
  como >press the enter key
  que hace nada pero que esta diseado a hacer el documento ms
  interesante para leer. Quiero trasducir este punto hasta 
  piezas de texto en espaol, pero no s cuando.
  
  Tambin en ingles si teclas -->> warning: --<< debe resultar
  como warning:  pero no s si est funcionando ahora

  Tambin los nombres de ficheros deben parecer un poco diferente
  de los dems texto como /sendero/hasta/un/fichero.html 


* Un Aviso

  Si pulsas escape cuando ests editando un documento puede ser
  que vas a perder tu trabajo (tus cambios). Asegurarte a 
  guardar tus cambios frecuentemente haciendo servir el botn
  SAVE FILE.

* Notas Tcnicas

  El HTML fabricado automaticamente por el sistema es HTML 4
  y no XHTML

* El proceso de funcionamiento

  Las pginas web solamente son creados o puestos al da cuando pulsas
  el botn SAVE FILE. Cuando ests editando un documento, en realidad
  ests editando un documento de texto plano que tiene el mismo 
  nombre como la pgina web pero tiene un extencin de fichero diferente
  (txt en lugar de html). Eso quire decir que a veces los cambios que
  hagas no parezcan immediatemente despus de editar el documento.
  Por ejemplo, si editas el documento template, los cambios no parecen
  en las pginas web hasta que regeneres los documentos debidos. 
  Eso no es muy bien explicado. 

  This document is available in "English" link:///refurb/docs/wiki-language.html
  

[*document*]                                                                                                                                                                            