muRF is intentionally designed to be as simple to use as possible. In most cases it is simply a case of using existing HTML tags to their full potential. In others there may be one or two new attributes added to a HTML tag. Finally there is the definition of a new tag for handling referencing. This guide covers the use of the new & existing tags to make your content muRF-ready.

Getting Started

Before reading this guide it will be useful if you are familiar with the basics of HTML. If you don’t know what that means don’t worry – if you’re already writing posts on your website or blog it quite likely you already know everything you need to know.

If you want to brush up on a bit of HTML before you get started, one good resource is the W3Schools HTML Tutorials which will cover most of the basics you’ll need.

Link Types

Basic muRF markup comes with 5 basic tag types, which represent the 5 different types of document relationship available in HTML.

Link to new information: Link (Anchor)
Link to additional information: Abbreviation / Acronym
Link to same information as substantiation: Reference
Link to the same information in context: Quotation
Link to explanation for change: Insertion / Deletion

More information is available on the link-relationships and design decisions but for the purposes of this tutorial all you need to know is that different types do exist. It is these different types of tag that muRF is concerned with.

Tag Usage

Each link type and associated HTML tags will be covered in turn.

Link (Anchor)

Use as normal. Wrap your links with the &lta href=””> </> tags.

<a href="http://www.mutube.com">mutube.com&lt/a>

Displays:

mutube.com

Abbreviation / Acronym

As well as the standard title=”” attribute, abbreviation and acronym tags support an additional cite=”” attribute to mark a source for information. Use as follows:

<acronym cite="http://www.mutube.com/labs/muRF" title="mu Referencing Framework">muRF</acronym>

or

<abbr cite="http://www.mutube.com/labs/muRF" title="mu Referencing Framework">muRF</abbr>

Displays:

muRF

Quotation

Both quotations <q> and <blockquote> both already support the cite=”” attribute and can be used as normal. Simply take care to look up a relevant citation while writing your document.

<blockquote cite="http://www.quotationspage.com/quote/3503.html">A man's ethical behavior should be based effectually on sympathy, education, and social ties; no religious basis is necessary. Man would indeed be in a poor way if he had to be restrained by fear of punishment and hope of reward after death.</blockquote>

Displays:

"A man’s ethical behavior should be based effectually on sympathy, education, and social ties; no religious basis is necessary. Man would indeed be in a poor way if he had to be restrained by fear of punishment and hope of reward after death."

Reference

References are marked using a new tag <ref cite=””> which is used in the same was as the inline quotation tag.

<ref cite="http://www.mutube.com/labs/muRF">muRF is a new method of referencing online documents.</ref>

Displays:

muRF is a new method of referencing online documents.

Insertion / Deletion

As with quotations, insertion/deletion tags already come with a cite=”” attribute for looking up a source with reasons as to the change. Simple use these as intended:

<ins cite="http://www.mutube.com/labs/muRF">muRF is great.</ref>

<del cite="http://www.mutube.com/labs/muRF">muRF is rubbish.</del>

Displays:

muRF is rubbish
muRF is great

Advertisements

Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: