<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>HelpOnEditing</title></articleinfo><section><title>Editing</title><section><title>Page Editing</title><para>Names of pages may either <code>LookLikeThis</code> (that is called a <ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/WikiName#">WikiName</ulink>) or <code>[[Like this]]</code> (a so-called free link). If you write a word that <ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/LookLikeThis#">LookLikeThis</ulink>, it will be automatically turned into a link. More details about this you find on <ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpForBeginners#">HelpForBeginners</ulink>. </para><para>The following pages describe the elements (wiki markup) you can use to get special formatting effects: </para><itemizedlist><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnFormatting#">HelpOnFormatting</ulink> - general text formatting rules </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnLinking#">HelpOnLinking</ulink> - external hyperlinks and inline images </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnHeadlines#">HelpOnHeadlines</ulink> - section headings </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnRules#">HelpOnRules</ulink> - horizontal rules </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnLists#">HelpOnLists</ulink> - lists and indented sections </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnTables#">HelpOnTables</ulink> - tables </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnDictionaries#">HelpOnDictionaries</ulink> - dictionaries </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnSmileys#">HelpOnSmileys</ulink> - how to insert a <inlinemediaobject><imageobject><imagedata depth="16" fileref="https://imaging.mrc-cbu.cam.ac.uk/basewiki/moin_static1910/moniker_cbu/img/smile.png" width="16"/></imageobject><textobject><phrase>:)</phrase></textobject></inlinemediaobject> </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnMacros#">HelpOnMacros</ulink> - Macros allow you to use dynamic elements in a page </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnParsers#">HelpOnParsers</ulink> - data processing parsers </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnProcessingInstructions#">HelpOnProcessingInstructions</ulink> - how to influence page formatting  </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnVariables#">HelpOnVariables</ulink> - how variables work </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnXmlPages#">HelpOnXmlPages</ulink> - how to store pages with XML content and process them via XSLT </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnEditLocks#">HelpOnEditLocks</ulink> - how to behave correctly when edit locking is activated </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnCategories#">HelpOnCategories</ulink> - how to group wiki pages </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnEditing/SubPages#">/SubPages</ulink> - how to group together related information </para></listitem><listitem><para><ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/HelpOnAdmonitions#">HelpOnAdmonitions</ulink> - how to put a warning, a note, a tip, mark caution </para></listitem></itemizedlist><para>To experiment with wiki markup, go to the <ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/WikiSandBox#">WikiSandBox</ulink> and then click on &quot;Edit<emphasis role="strong"/>Text&quot; at the bottom of the page. Use your browser's &quot;open a new window with this link&quot; feature on the word &quot;<ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/WikiSandBox#">WikiSandBox</ulink>&quot;, so you can keep the help pages open side-by-side to the editing window. </para></section><section><title>Automatic Backup of Drafts</title><para>Every time you are in the editor and use the &quot;Preview&quot;, &quot;Spell Check&quot;, &quot;Cancel&quot; or &quot;Save Changes&quot; buttons, moin saves a draft copy of your work internally. Use preview often! </para><para>If you hit &quot;cancel&quot; accidentally, your machine crashes, or the browser window was accidentally closed, then the automatic backup of your draft may be easily recovered. </para><para>To recover that draft, you simply edit that page again. If there is a draft, an alert message will be in the message box and a &quot;load draft&quot; button will be present.  Clicking the &quot;load draft&quot; will load your saved draft into the editor box replacing the current revision already loaded. You can continue editing the loaded draft, but this time try to save it at the end. <inlinemediaobject><imageobject><imagedata depth="16" fileref="https://imaging.mrc-cbu.cam.ac.uk/basewiki/moin_static1910/moniker_cbu/img/smile.png" width="16"/></imageobject><textobject><phrase>:)</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing?action=AttachFile&amp;do=get&amp;target=load_draft.png"/></imageobject><textobject><phrase>load_draft.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="https://imaging.mrc-cbu.cam.ac.uk/basewiki/moin_static1910/moniker_cbu/img/idea.png" width="16"/></imageobject><textobject><phrase>(!)</phrase></textobject></inlinemediaobject> Don't use the &quot;preview&quot;, &quot;spell check&quot;, &quot;save changes&quot; or &quot;cancel&quot; buttons on that page before &quot;load draft&quot; or you will overwrite your old draft with a new one. </para><para>If you successfully save a page, the internal draft copy of it is not needed any more and will be deleted. </para><para><anchor id="EditorOnDoubleClick"/> </para></section><section><title>Open Editor On Double Click</title><para>When viewing a page that the user is authorized to edit, the editor can be opened by double-clicking on the line to be edited.  If the text editor was selected in user preferences, the editing textarea will be scrolled and the caret positioned on or near the line that was double-clicked. If the GUI editor is selected, the GUI editor will open but the editing area will not be scrolled. </para><section><title>Setup</title><para>To use this feature, logged-in users must have the <emphasis>Open Editor On Double Click</emphasis> option selected in their user preferences.  For the auto-scrolling feature, select <emphasis>text</emphasis> as the <emphasis>Editor Preference</emphasis>.   </para><para>Users who are not logged-in will have the open editor on double-click option if their local wiki has the option <code>user_checkbox_defaults = {'edit_on_doubleclick': 1}</code> set in wikconfig.py or farmconfig.py.  As of <ulink url="https://imaging.mrc-cbu.cam.ac.uk/basewiki/HelpOnEditing/basewiki/MoinMoin#">MoinMoin</ulink> 1.9.3 this option is set on by default. </para></section><section><title>Where to Double-Click</title><para>Double-clicking works on the edit draft preview page as well as on the wiki page view. </para><para>In general, double-click directly on the text, image, table, or list that requires editing.  One exception to this rule is the editing of hyperlinks. To edit a hyperlink, double-click on nearby plain text or on the blank space directly to the right of the hyperlink. </para><para>There are double-click dead spaces within the wiki page where double-clicking will have no effect.  These areas include: </para><itemizedlist><listitem><para>blank space between (above and below) paragraphs, images, tables, etc. </para></listitem><listitem><para>theme headers and footers </para></listitem><listitem><para>page margins (blank space in far left and right sides) </para></listitem><listitem><para>immutable pages (pages you are not allowed to edit) </para></listitem><listitem><para>pages using the Creole or RST formatters </para></listitem></itemizedlist></section><section><title>Scrolling Accuracy</title><para>Positioning of the caret is based upon the line number of the text and data in the raw wiki markup.  The caret can not be positioned on the exact character or word that was double-clicked. </para><para>In general, the best results are presently obtained with current versions of the Firefox, Chrome, and Safari browsers.  Most of the time these browsers will scroll the textarea so the line or paragraph that was double-clicked will be near the top of the edit textarea and the caret will be positioned on the left margin. </para><para>The IE and Opera browsers will scroll the textarea and place the caret in or near the selected line or paragraph.  IE will scroll the textarea so the target is near the bottom of the textarea. Short lines of text tend to increase the vertical error in placing the caret. </para></section><section><title>Workarounds</title><section><title>Editor Size of 0</title><para>If the editor size in user preferences is set to 0, then the editor textarea size will expand to encompass the entire document and the window may not scroll so the caret is visible.  Pressing the keyboard right-arrow will scroll the window. </para></section><section><title>Opera Displays Context Menu on Double-Click</title><para>To turn off this Opera feature, click on Settings &gt; Preferences &gt; Advanced &gt; Toolbars and uncheck the box labeled <emphasis>Double-click text to display context menu</emphasis>. </para></section><section><title>Caret Misses Target Line</title><para>If preformatted text is enclosed in triple curly braces, double-clicking on any line within a block of preformatted text will position the caret on the last line.   </para></section></section></section></section></article>