Printed from http://www.Writing.Com/view/101
Printer Friendly Page Tell A Friend
Rated: E · Book · Other · #101
Explanations and instructions of all things Writing.Com.
#698725 added May 18, 2016 at 10:24pm
Restrictions: None
Enhance Your Item With WritingML
WritingML is the mark-up language used within Writing.Com that allows you to enhance your writing on our web-based system. Everything you need to embellish and enhance your writing can be found in the WritingML: Docs & Help pop-up window linked under Writing.Com Tools in the main navigation at the left. Tags for basic text formatting, such as bold, italic, and underline, are provided, as well as more complex tags, such as linking to members and items, embedding images, and footnotes.

WritingML is a markup language similar to HTML. If you are familiar with HTML, you will find it easy to learn. If you have not worked with HTML before, you may still find it easy to learn after reading through the simple descriptions, instructions and examples for each. We encourage you to experiment with the tags to become familiar with them and get creative with them!

The WritingML Formatting Button Bar
A bar of WritingML formatting buttons appears across the top of most writing or editing textboxes to facilitate your editing process. The button bar includes the most commonly used formatting options. The button bar makes it easy to add font attributes (bold, italic, underline, etc.), change the justification of your text, or re-format entire passages with a few clicks. Just highlight the text you wish to modify and click the appropriate button to add the tags around your highlighted text. If you make a mistake, highlight the tags and the text, and click the button again to remove the tags. If you're not sure what a particular button does, hover your cursor over it for a description. Note that some browsers require you to open a button that has a submenu before highlighting your text.

The Script M Button and Other Keyboard Shortcuts
Members with an Upgraded membership or higher can create their own keyboard shortcuts, called macros. These macros can be invoked at the cursor position with keyboard combinations, or by clicking the script M button to open the Macro submenu, and clicking on the desired macro. For details, see "Macros.

Some generic keyboard shortcuts, such as Ctrl-S for the Save command, also work in these writing or editing text boxes.

The ? Button
The formating button labeled ? links to WritingML: Docs & Help for additional WritingML tags that you can copy/paste to your text and fill in.

         Visit the WritingML: Docs & Help page here: WritingML Help
         *Clapper* View a tutorial video: Video: Linking to an Item

The *Smile* Button and WritingML: Emoticons
The formatting button labeled *Smile* opens the WritingML: Emoticons page in a pop-up window. The directory has a menu of sorting options at the top and can be sorted by emoticon name (alphabetically), category, or color. The default view is Show as Groups/By Category/Show Headers. In the Show as Groups options, when you click on an emoticon, the tag for that emoticon is displayed for you to copy/paste to your text; for example: {e:Cool} yields *Cool*. Note that the label Tag: does not need to be copy/pasted. In the Show as List options, you can click an icon to copy its WritingML to your clipboard, from which you can then paste it into your text.

The directory of over 900 emoticons is also linked as WritingML: Emoticons under Writing.Com Tools in the main navigation on the left.

         Visit the WritingML: Emoticons page here: List of WDC Emoticons

Linking to WritingML Help
Sometimes it's helpful to include a direct link to a particular WritingML tag so that other members can quickly and easily read about it.

To get the specific section of the pop-up to open, you must use the part of the WritingML [opening] tag located between the braces or between the opening brace and the colon (for more complicated tags). For example:

To open the section on bold, the WritingML open bold tag is {b} so the part to use is b and the link is {code:WritingML:b}, which produces: WritingML Help for b

To open the section on linking to Book entries, the WritingML tag is {entry:######} so the part to use is entry and the link is {code:WritingML:entry}, which produces: WritingML Help for entry

The correct section does not open until after the pop-up finishes loading.
If more than one section uses the same WML identifier, all those sections will open.
Pending further programming, some of the more recent additions to the WML don't have a working specific-code link.
The specific-code link won't open the sections on Random Rotation or Display WritingML Example, which depend on delimiter usage rather than tags.

To see the exact WritingML links to use and more examples of how to do this, see WritingML Help for writingml and WritingML Help for tag.

Posting Unprocessed WritingML
Sometimes it's helpful to show unprocessed formatting tags in text, such as in giving directions, sharing a template, or asking for help with a formatting problem. Using doubled braces {{ and }} makes the formatting tags show as unprocessed. One way of doing this is to put {db} and {/db} tags around the formatting tags. See WritingML Help for db.

Some Pointers for Using and Troubleshooting WritingML
*Bullet* When you open a paired tag, you must close it.
*Bullet* When you open several paired tags together to format the same section of text, you must close them in the reverse of how they were opened (last opened, first closed).
*Bullet* When you have a long string of tags, either formatting tags or emoticon strings, you should include spaces between some of the tags to avoid problems caused by having a character string longer than the allowed line length. Such problems can include broken tags that were not mistyped, stretching the page or column width, and text running behind the right column.
*Bullet* Some tags, such as center and quote, automatically add a blank line at the end of the formatted text.
*Bullet* The default font size is Size 3.
*Bullet* The lightest colors can be difficult to read. Some readers may need to highlight such text to see what it says.
*Bullet* The footnote button adds the tag pair around the highlighted text for the footnote, or adds the tag pair at the cursor if no text is highlighted. Afterward, in the leading tag you may change the style of the automatic numbering if you wish, as described in WritingML Help for footnote. The default numbering is numeric.
*Bullet* The dropnote and popnote buttons add the tag pair around the highlighted text for the inside of the dropnote or popnote, or add the tag pair at the cursor if no text is highlighted. Afterward, in the leading tag you replace the text within the quotation marks (LINK TEXT HERE) with your own link text (the marked text that indicates the dropnote or popnote when the note is closed). Do not replace or delete the quotation marks. Note that your link text should not include quotation marks or apostrophes, or a userlink. When your desired link text doesn't work, consider using only the closing punctuation and/or a following space or {s}{s} as the link text.
*Bullet* Some tags are complex enough that they cannot be nested inside another one. For example, you cannot use a quote tag inside another quote tag, or a dropnote tag inside another dropnote tag.
*Bullet* Some tags (such as b-item links and dropnotes) do not react well to being inside other tags (such as font attributes). You may need to close the other tag set before the fussy tag and reopen the other tag set after.
*Bullet* Popnote tags do not work in macros, and popnotes can be problematic in Mobile view.
*Bullet* Using the browser Find function (Crtl-f) can be helpful in proofreading and troubleshooting your WritingML tags.

If you still have questions, visit "Technical Support Forum.1

Recommended Reading

Related and Recommended

1  Updated by Northernwrites ; written by The StoryMaster and The StoryMistress

© Copyright 2016 The StoryMistress (UN: storymistress at Writing.Com). All rights reserved.
The StoryMistress has granted Writing.Com, its affiliates and its syndicates non-exclusive rights to display this work.
Log in to Leave Feedback
Not a Member?
Signup right now, for free!
All accounts include:
*Bullet* FREE Email @Writing.Com!
*Bullet* FREE Portfolio Services!
Printed from http://www.Writing.Com/view/101