The XPJ articles format

di: Marco Marongiu, Marina Sturino.

Sommario

Indice

1. This title can contain PCDATA

We write the title into an element, so that we can use parsed entities¹. If we write as an attribute value, we must use CDATA only, and we don't want it!

Text should be written in paragraphs, using the p tag.

We have a tag to emphasize keywords, so that they can be used by (XSLT, XPathScript,...) stylesheets to compose META tags in HTML, dc:subject tags in RDF and so on.

2. Chapters can have sections, too

Yes, they really do!

2.1 Embedding code in articles

Short, inline sections of computer code, like commands for example, are marked using the code tag. Longer blocks of code should use the listing tag instead. For example:

	#!/bin/bash
	
	# This section of code should be written as-is
	# It is good practice to put it inside a [CDATA[...] section
	# to avoid character escaping.

	# How a system administrator makes love:
	
	touch me
	make love
	more sex
	yes please
      

3. Lists

You can have lists, even nested lists. Lists can contain PCDATA, keywords, emphasis or links and anchors. No other elements are allowed.

• first item
• second item
• second.first item
• second.second item
• item with a keyword
• third item

4. Links and anchors

We have the link tag to create links, like this, for example. We use the url attribute to create links and the id attribute to create anchors, which we could refer to.

5. What about tables

Yes, XPJ has tables, too! Let's see:

6. Figures blocks

Figura 1: A small caption here	Figura 2: Another figure, another caption

7. Other chapter-like sections

You have the appendix tag for appendix chapters. All tags that are valid into chapters tag are allowed into appendix.

You also have the bio tag, for authors' biographies.

Appendice A
Other toys

A.1 Style modifiers

• Use the emph tag to emphasize text;
• use the sup tag for ^superscripts;
• use the sub tag for _subscripts

A.2 Footnotes

Yes, you have footnotes². You should be thankful about it!

Bibliografia

Note

¹ You can't imagine how disappointing is to find that your attribute values don't show up right after the XML document has been transformed!

² we know you need them

Marco Marongiu is just another perl hacker. Don't contact him, he is nasty!

Marina Sturino is just another XSLT hacker. Contact her instead!

Hanno collaborato: Nicola Fragale, Germano Rizzo, The PLUTO Journal Staff.