Help For 'Invisible Markup Language'
[edit this web-page]
ENGLISH VERSION
A. INTRODUCTION
B. VARIOUS TRICKS TO USE
C. CODES AFTER THE PAGE TITLE
D. BLOCK TAGS
VERSIÓN ESPAÑOL
C. CODES AFTER THE PAGE TITLE
VERSIÓ CATALÀ
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.
* 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
* 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 (Formats: html | text | xml | pdf)
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.
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)
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 <b> 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
* 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 (Formats: html | text | xml | pdf)
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)
encara no fe
abc
g