= Help For 'Invisible Markup Language' [] {} ENGLISH VERSION A. INTRODUCTION The appearance of the final HTML (web) page depends on the way that you edit the edit box on the 'wiki' page. You do not need to write HTML (in fact, you shouldn't, unless you want to give an example of HTML code for some reason). The text you edit in the box above gets automatically transformed in HTML in predetermined ways. I refer to this as 'Invisible Markup Language' (IML) or Mas o Menos Markup Language (MMML). The basic idea is to have as little actual 'markup' in the text document as possible. (If you dont know what markup is, don't worry you dont need to know, just edit the text above normally). The markup which is present should 'look good' in the plain text file. So, instead of using, say, %^* Section Heading which is valid markup but looks ugly in the text file, we use all capitals to indicate a section heading. A section heading is just a title which delineates a part of the text you are editing, and which can form part of a hyperlinked table of contents, if you want one. (See below for how to make tables of contents in the web-page) which looks better in the text file. B. VARIOUS TRICKS TO USE * A line beginning with = is the web-page title. It should be at the top of the text and there really should be only one, but it doesn't really matter. EXAMPLE: = Mediterranean Cooking * A line beginning with '*' will be hyperlinked if what comes after looks like links. EXAMPLE: * http://www.google.com * URLs get automatically hyperlinked in some non-determinate way. Urls need to start with http:// or www. * If you want the hyperlink to have a different display text then write your URLs like this: -->> "A link to Google" http://www.google.com --<< And they will appear like this "A link to Google" http://www.google.com * Capitals lines are section headings. These section headings may then be used as a table of contents and hyperlinked in various ways Example: ALIOLI RECIPES * If you want to make a 'fake' heading you can write -->> {{ My Fake Heading }} --<< And it will appear like {{ My Fake Heading }} but it wont be included in the table of contents (if you put a [] after the page title, for example) * Blocks of text surrounded by '-->>' and '--<<' are not 'formatted' in any way If you want something to look exactly as you type it then surround the block of text in this. Example: -->> first-name last-name ---------- --------- nuria vilaverde marc leon --<< * If you have lots of versions (formats) of a file which you what to provide links to you can write -->> * My Interesting File|/my/path/to/file-no-extension|html|txt|xml|pdf| --<< And it will appear like this * My Interesting File|/my/path/to/file-no-extension|html|txt|xml|pdf| C. CODES AFTER THE PAGE TITLE Certain codes can also be placed after the document title (indicated by an '=' and text- see above) in the source text file to influence the appearance of the HTML. -->> {x} means number all section headings (including in the Table of Contents) {~} means make the section heading into 'capital case' (All upper case letters) This is not working very well at the moment (july 2003) These can be combined as in {~x} [] means display the table of contents, made up of all the section headings and hyperlinked [~] means display the TOC with items in 'capital case' (+) means display automatic google translation links in the HTML (XX) means display the 'messages' on the web page in the specified language. For example (ES) means display the messages in the HTML in spanish. The XX codes are the standard web language codes. --<< D. BLOCK TAGS This system also understands some 'block' tags such as -->> [IMAGE-INDEX-BEGIN.] and [IMAGE-INDEX-END.] --<< (Actually there are no dots before the ] character) Any information placed between these two 'tags' will be interpreted as an 'image index'. This is the sort of this where you have an image which is a hyperlink and a textual description of that link. See http://poseidonia.ella-associates.org/ for and example of how this actually works (click on the 'edit' button to see the actual text for the page) The other 'block' tags which this system understands are -->> [BAND-DETAIL-LIST-BEGIN.] and [BAND-DETAIL-LIST-END.] --<< (Actually there are no dots before the ] character) Information between these tags is seen as a list of musical bands with possibly a photo of the band, and some links to the music for the band. For example if you typed ... -->> Image: bands/monkeyrhythm/nick-and-joe-bw.jpg Nombre: Monkey Rhythm Nacionalidad(es): Reino Unido, Australia Estilo: Alternativo-acéstico N� de m�sicos: 2 P�gina Web: www.monkeyrhythm.com Ejemplos de m�sica: "She" bands/monkeyrhythm/she.mp3 "Given Night" bands/monkeyrhythm/givennight.mp3 "Wearing Fin" bands/monkeyrhythm/wearingfin.mp3 --<< This would be made into a listing of a band with the image and links to their music. You could include any number of these bands within the block tags You can see a complete example of these tags being used at the url http://poseidonia.ella-associates.org/band-details.html . Tal vez, cuando regreses a la p�gina web, los cambios tu has hecho no van a aparecer en el p�gina web hasta que tu pulses el boton 'actualizar' en tu hojeador. Incluso, en algunos hojeadores tu necesitas cerrar y abrir tu hojeador para que tu puedas ver los cambios (perdon por este rollo) Gracias In some cases, when you go back to the web-page, you will not see the changes which you have just made until you press the 'refresh' button in your browser. With some browsers (notably Microsoft Internet Explorer) you actually have to close and open the browser in order to see the changes (sorry) VERSIÓN ESPAÑOL Incompleta. Tambi�n, puede ser que los versiones en differentes lenguajes no son simplemente traducimientos del versi�n ingl�s. Por favor, corregir mi espa�ol si quieres. (Haz clic en el bot�n abajo) La apariencia de la p�gina web depende de la manera en que tu la edites el texto. No hace falta escribir HTML (de hecho, est� mejor si no lo haces, menos esta situaci�n en que quieres dar un ejemplo de los c�digos HTML por alguna raz�n. El texto que edites en el cajita encima est� transformado auticomaticamente en HTML cuando haces clic en el bot�n que dice algo c�mo "Guardar tus cambios" Esta sistema se llama 'El lenguaje de etiquetas invisibles' o 'El Mas o Menos Lenguaje' La idea es tener el m�nimo n�mero de 'c�digos' o etiquetas en el texto del documento. En este sentido las palabras 'c�digos' y 'etiquetas' se refiere a car�cteres especiales para indicar la apariencia del documento cuando ha estado transformado. Por ejemplo en la sistema HTML hay muchisimas etiquetas que cambian la apariencia del documento. En concreto, el etiqueta hace el texto m�s 'fuerte'. En mi sistema, s� hay alguna etiquetas pero son muy pocas y sencillas. Si no entiendes el significado del palabra etiqueta no importa. De todas maneras puedes editar los documentos igualmente. * A line beginning with = is the web-page title. It should be at the top of the text and there really should be only one, but it doesn't really matter. EXAMPLE: = Mediterranean Cooking * A line beginning with '*' will be hyperlinked if what comes after looks like links. EXAMPLE: * http://www.google.com * URLs get automatically hyperlinked in some non-determinate way. Urls need to start with http:// or www. * If you want the hyperlink to have a different display text then write your URLs like this: -->> "A link to Google" http://www.google.com --<< And they will appear like this "A link to Google" http://www.google.com * Capitals lines are section headings. These section headings may then be used as a table of contents and hyperlinked in various ways Example: ALIOLI RECIPES * If you want to make a 'fake' heading you can write -->> {{ My Fake Heading }} --<< And it will appear like {{ My Fake Heading }} but it wont be included in the table of contents (if you put a [] after the page title, for example) * Blocks of text surrounded by '-->>' and '--<<' are not 'formatted' in any way If you want something to look exactly as you type it then surround the block of text in this. Example: -->> first-name last-name ---------- --------- nuria vilaverde marc leon --<< * If you have lots of versions (formats) of a file which you what to provide links to you can write -->> * My Interesting File|/my/path/to/file-no-extension|html|txt|xml|pdf| --<< And it will appear like this * My Interesting File|/my/path/to/file-no-extension|html|txt|xml|pdf| C. CODES AFTER THE PAGE TITLE Certain codes can also be placed after the document title (indicated by an '=' and text- see above) in the source text file to influence the appearance of the HTML. -->> {x} means number all section headings (including in the Table of Contents) {~} means make the section heading into 'capital case' (All upper case letters) This is not working very well at the moment (july 2003) These can be combined as in {~x} [] means display the table of contents, made up of all the section headings and hyperlinked [~] means display the TOC with items in 'capital case' (+) means display automatic google translation links in the HTML (XX) means display the 'messages' on the web page in the specified language. For example (ES) means display the messages in the HTML in spanish. The XX codes are the standard web language codes. --<< D. ALGUNOS ETIQUETAS �TILES This system also understands some 'block' tags such as -->> [IMAGE-INDEX-BEGIN.] and [IMAGE-INDEX-END.] --<< (Actually there are no dots before the ] character) Any information placed between these two 'tags' will be interpreted as an 'image index'. This is the sort of this where you have an image which is a hyperlink and a textual description of that link. See http://poseidonia.ella-associates.org/ for and example of how this actually works (click on the 'edit' button to see the actual text for the page) The other 'block' tags which this system understands are -->> [BAND-DETAIL-LIST-BEGIN.] and [BAND-DETAIL-LIST-END.] --<< (Actually there are no dots before the ] character) Information between these tags is seen as a list of musical bands with possibly a photo of the band, and some links to the music for the band. For example if you typed ... -->> Image: bands/monkeyrhythm/nick-and-joe-bw.jpg Nombre: Monkey Rhythm Nacionalidad(es): Reino Unido, Australia Estilo: Alternativo-ac�stico N� de m�sicos: 2 P�gina Web: www.monkeyrhythm.com Ejemplos de m�sica: "She" bands/monkeyrhythm/she.mp3 "Given Night" bands/monkeyrhythm/givennight.mp3 "Wearing Fin" bands/monkeyrhythm/wearingfin.mp3 --<< This would be made into a listing of a band with the image and links to their music. You could include any number of these bands within the block tags You can see a complete example of these tags being used at the url http://poseidonia.ella-associates.org/band-details.html . Tal vez, cuando regreses a la p�gina web, los cambios tu has hecho no van a aparecer en el p�gina web hasta que tu pulses el boton 'actualizar' en tu hojeador. Incluso, en algunos hojeadores tu necesitas cerrar y abrir tu hojeador para que tu puedas ver los cambios (perdon por este rollo) Gracias In some cases, when you go back to the web-page, you will not see the changes which you have just made until you press the 'refresh' button in your browser. With some browsers (notably Microsoft Internet Explorer) you actually have to close and open the browser in order to see the changes (sorry) VERSIÓ CATALÀ encara no fe background-color: #009933 css-style-sheet: /stylish.css section-heading-css-class: title2 abc g