|4. All About h2g2 / All About h2g2 / h2g2 Information / Help and Frequently Asked Questions|
4. All About h2g2 / All About h2g2 / h2g2 Information / Asking Questions and Making Comments About h2g2
4. All About h2g2 / All About h2g2 / h2g2 Information / GuideML, the Markup Language of the Guide
The GuideML Clinic
Welcome to the GuideML Clinic. This is the place to come to find out more about GuideML, the markup language of H2G2, and the place where you can influence its future development.
We've put together a collection of useful entries that you'll find handy when creating your own Entries in GuideML. These include:
If you have any questions or comments about GuideML that aren't already answered in these pages, just ask in the Conversation Forum below - the Gurus regularly check these forums and will do their best to help. You can also ask about using HTML and plain text in Entries, and if you know the answer to other Researchers' questions, do help out. GuideML is flexible, easy to learn and great fun to use, and we hope the Clinic helps you get the best out of it.
Many thanks to Bruce for his sterling work on the GuideML Clinic - Bruce, you're a champ!
GuideML and HTML
HTML is the markup language of the Web. For a page to be viewed in a browser, it has to be in HTML. HTML codes can be in upper or lower case, but current practice is to use lower case, so we'll stick to that here.
GuideML is h2g2's own markup language. You can enter your pages in GuideML and the h2g2 engines look after translating it into HTML behind the scenes. This means that you can do things like putting footnotes onto an entry very simply using GuideML, where the HTML to do the same task would be very difficult.
GuideML must be put in uppercase, as it will often misbehave or do nothing at all if it is entered in lowercase. So we'll list all GuideML tags in uppercase.
Other than the distinction between upper and lowercase, you don't really need to think of HTML and GuideML as two separate things. You can mix them together as you like.
Here are all the tags officially supported in GuideML, as well as the more useful HTML Tags. Please note that you can also use most HTML tags in GuideML entries, as long as they follow the syntax rules, but we don't have the space to list them all here, and support for them is not guaranteed in the future.
Some GuideML and HTML tags are approved for inclusion in entries in h2g2; the other tags, while not approved, are still available for use on Personal Spaces, Community pages and so on. In a nutshell, you should stick to Approved GuideML if you intend to submit your entry to Peer Review; otherwise you are free to use any GuideML and HTML tags that work (though you should note that some GuideML tags are deprecated, and support for these is not guaranteed in the future). For more information on Approved GuideML, check out the entry on Using Approved GuideML in the Approved version of H2G2 entry.
The following HTML tags are approved for use within all GuideML entries, including Approved Entries:
The following GuideML tags are approved for use within all GuideML entries, including Approved Entries:
The following tags are fine to use in your entries, but if you want to put your entry through the Peer Review system you shouldn't use them, as they will simply be stripped out when the entry is edited for the Edited Guide.
The following HTML tag is not approved for use in Approved Entries, because it creates something that looks like a link but isn't. Confusing!
The following tags provide various gadgets that you may like to use in your entries. They don't mark up text according to its content, but provide things like drop-down menus and useful Community tools. You can suggest new gadgets on the GuideML Gadgets Page.
The following tag is deprecated, and you should not use it in your entries; it is only listed here for completeness.
People have been talking about this Guide Entry. Here are the most recent Conversations:
Please note that Not Panicking Ltd is not responsible for the content of any external sites listed.