MONDAY
20th May 2013
Text only
Become a member
Sign in
Front Page
Help!
Feedback
Who is Online
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:

  • An Introduction to GuideML
  • GuideML Syntax
  • Known Bugs with Certain Browsers
  • GuideML Frequently Asked Questions
  • Special Character Codes in GuideML and HTML
  • Using Approved GuideML in the Approved version of H2G2
  • GuideML Gadgets Page
  • H2G2 Picture Library

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.

GuideML Tags

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.

Approved GuideML

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:

  • <b> - Bold text.
  • <br/> - Line break.
  • <code> - Programming language excerpt.
  • <hr/> - Horizontal rule.
  • <i> - Italic text.
  • <ol> and <li> - Ordered (numbered) list.
  • <p> - Paragraph.
  • <pre> - Fixed format text.
  • <sub> - Subscripted text.
  • <sup> - Superscripted text.
  • <table> - Table.
  • <ul> and <li> - Unordered (bulleted) list.

The following GuideML tags are approved for use within all GuideML entries, including Approved Entries:

  • <BODY> - Entry body.
  • <BLOCKQUOTE> - Block of quoted text.
  • <CREDITS> - Credit a Researcher or a list of Researchers on an Edited Entry.
  • <ENTITY> - Numerical character entities.
  • <FOOTNOTE> - Automatic footnote.
  • <GUIDE> - Denotes a GuideML entry.
  • <HEADER> - Header.
  • <LINK> - Link to Guide Entries, Researchers and external websites.
  • <PICTURE> - Picture.
  • <REFERENCES> - Add links to the Entry Data box.
  • <SUBHEADER> - Subheader.
Non-Approved GuideML

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.

  • <ADDTHREADINTRO> - Add content to the 'Post to a Conversation' page.
  • <BOX> - Boxed text.
  • <BOXHOLDER> - Two-part boxed text.
  • <BRUNEL> - Change the colour of Personal Spaces in the Brunel skin.
  • <FORUMINTRO> - Add content to Conversation list.
  • <FORUMTHREADINTRO> - Add content to Conversations and Conversation list.
  • <INTRO> - Entry introduction.
  • <PULLQUOTE> - Boxed quote.
  • <SMILEY> - Smileys.
  • <SITEFILTER> - Tailor Personal Space for DNA sites.
  • <THREADINTRO> - Add content to Conversations.
  • <VIEWER> - Inserts the visitor's name at a given point in the text.

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!

  • <U> - Underlined text.
GuideML Gadgets

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.

  • <GUESTBOOK> - Enable Researchers to post to specific Forums or Conversations.
  • <ITEM-LIST> - Drop-down menus of entries, Researchers or websites.
  • <POPUPCONVERSATIONS> - Link to the Conversations popup window.
  • <VOLUNTEER-LIST> - Drop-down menus of h2g2 volunteers.
  • <WHO-IS-ONLINE> - Link to the Who's Online popup window.
Deprecated GuideML

The following tag is deprecated, and you should not use it in your entries; it is only listed here for completeness.

  • <SECTION> - Section.

Discuss this Entry

People have been talking about this Guide Entry. Here are the most recent Conversations:
LINK BIO and Preview mode (Last Posting: Nov 18, 2011)
Bad Pages (Last Posting: Nov 6, 2011)
GuideMl: Non mathematical fractions (Last Posting: Oct 23, 2009)
GUIDEML Problem: Ampersand in <LINK> addresses. (Last Posting: Jul 20, 2009)
GuideDog (Last Posting: Jul 12, 2009)
Improved Preview Versus Posting (Last Posting: Mar 23, 2009)
Even More Confused (Last Posting: Mar 23, 2009)
Preview Versus Posting (Last Posting: Mar 22, 2009)
Ack, no wonder... (Last Posting: Jan 10, 2009)
Adding a Picture (Last Posting: Oct 9, 2008)
Click here to see more Conversations



Add your Opinion!

There are tens of thousands of h2g2 Guide Entries, written by our Researchers. If you want to be able to add your own opinions to the Guide, simply become a member as an h2g2 Researcher. Tell me More!

Entry Data
Entry ID: A187229 (Help Page)
Written and Researched by:
Bruce

Edited by:
The H2G2 Editors

Date: 11   October   1999


Referenced Guide Entries
Using Approved GuideML in Approved Entries
GuideML Gadgets
The Gurus' Home Page
h2g2 Picture Library
An Introduction to GuideML
Known Bugs with Browsers
GuideML - BODY Tag
GuideML - CODE Tag
GuideML - ENTITY Tag
GuideML - FOOTNOTE Tag
GuideML - HEADER Tag
GuideML - HR Tag
GuideML - I Tag
GuideML - LINK Tag
GuideML - OL and LI Tags
GuideML - PICTURE Tag
GuideML - PRE Tag
GuideML - REFERENCES Tag
GuideML - SUB Tag
GuideML - SUBHEADER Tag
GuideML - SUP Tag
GuideML - TABLE Tag
GuideML - UL and LI Tags
GuideML - ADDTHREADINTRO Tag
GuideML - BOX Tag
GuideML - BOXHOLDER Tag
GuideML - BRUNEL Tag
GuideML - FORUMINTRO Tag
GuideML - FORUMTHREADINTRO Tag
GuideML - INTRO Tag
GuideML - PULLQUOTE Tag
GuideML - SMILEY Tag
GuideML - THREADINTRO Tag
GuideML - GUESTBOOK Tag
GuideML - ITEM-LIST Tag
GuideML - POPUPCONVERSATIONS Tag
GuideML: B Tag
GuideML: BLOCKQUOTE Tag
GuideML: BR Tag
GuideML: GUIDE Tag
GuideML: VIEWER Tag
GuideML: P Tag
GuideML: U Tag
GuideML: VOLUNTEER-LIST Tag
GuideML: WHO-IS-ONLINE Tag
GuideML: SECTION Tag
GuideML: SITEFILTER Tag
GuideML Syntax
GuideML - CREDITS Tag


Referenced Researchers
Bruce


Referenced Sites
GuideML Frequently Asked Questions
Special Character Codes in GuideML and HTML
Using Approved GuideML in the Approved version of H2G2
GuideML Gadgets Page
syntax rules

Please note that Not Panicking Ltd is not responsible for the content of any external sites listed.

© BBC MMII
Terms & Conditions | Privacy