BBC Home

Explore the BBC

31st October 2014
Accessibility help
Text only
default banner
BBC Homepage

Knowledge Base
Who's Online

Book of the Future
Talk Buffy
Get Writing
Parent's Music Room

Contact Us

Like this page?
Send it to a friend!

New visitors: Create your membership
Returning members: Sign in

An Introduction to GuideML

Articles on DNA sites are stored on our servers in a markup language called GuideML. Before you all throw up your arms in disgust and wonder why on earth we've decided to go off and create something proprietary when everyone else is creating standards, don't worry: GuideML is actually based on XML, the latest and greatest buzzword on the scripting scene.

You see XML, the Extensible Markup Language, is a bit like a quirky HTML that you can extend by defining your own tags, and that's exactly what we've done. We store our articles in the database on our servers in this XML format, and using it we can add lots of extra information to articles that we otherwise couldn't, and can govern the look of the site more effectively. We've decided to call our XML language GuideML, because it gives us a chance to mix upper and lower case letters in one word in a way that XML doesn't, and being techies, we like that.

When you want to look at an entry on a PC, the GuideML gets translated to HTML (that your browser can display) by our GuideML parser. During this processing, any recognised GuideML tags are translated appropriately (and unrecognised ones are ignored). Effectively the format in which we store articles internally is like an enhanced HTML.

Similarly, when you look at a DNA site with a different skin (such as Classic Goo or Alabaster on h2g2), the GuideML parser translates GuideML into the correct HTML for that design. In this way you can access DNA sites in lots of different ways, and you only need to store your articles in one format - GuideML - for it to work.

Why Use GuideML?

So why should we bother with GuideML at all? The answer is two-fold. First, effects such as those generated by the <PULLQUOTE> tag, for example, are difficult to achieve in HTML, and second we can pull out extra information with GuideML tags that we can't with HTML because we're pre-processing it. A good example is the <LINK> tag in GuideML, which gets translated to an <A> tag in HTML, but not before the parser has checked to see what the destination entry of the link is so it can pull out the name of the article and display it in the 'Referenced Articles' section of the page.

We highly recommend that you write your articles in GuideML instead of plain text, as it enhances your entries considerably.

If you have any questions about, or problems with GuideML, the best place to go is the DNA GuideML Clinic.

Discuss this Article

People have been talking about this Article. Here are the most recent Conversations:
embedding pics (Last Posting: Oct 26, 2004)
Help! Help! (Last Posting: Jun 9, 2004)
Who's online tag (Last Posting: May 16, 2003)
Can you help me please? (Last Posting: Apr 29, 2003)
Chancing to GuideML (Last Posting: Apr 11, 2003)
how do I (Last Posting: Feb 7, 2003)
How do I..... (Last Posting: Jan 30, 2003)
A general question (Last Posting: Nov 7, 2002)
GuideMl (Last Posting: Sep 23, 2002)
Ampersands in URLs (Last Posting: Oct 9, 2000)
Click here to see more Conversations

Article Data
Article ID: A155701 (Help Page)
Written and Researched by:

Edited by:
Mark Moxon

Date: 06   September   1999

Most of the content on this site is created by our Members, who are members of the public. The views expressed are theirs and unless specifically stated are not those of the BBC. The BBC is not responsible for the content of any external sites referenced. In the event that you consider anything on this page to be in breach of the site's House Rules, please click here to alert our Moderation Team. For any other comments, please start a Conversation below.