Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: HTML editor.

HTML editor: Difference between revisions

From MoodleDocs
(11 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<p class="note">'''Note:''' There is a new HTML editor in Moodle 2.0 onwards. See [[HTML editor 2.0]] for details.</p>
Moodle has a standard toolbar that serves as an HTML interface.  Many of the icons on the tool bar can be found on most text editing (word processing) programs. This page will cover some of the icons/tools which may not be as familiar to a new user of Moodle.
Moodle has a standard toolbar that serves as an HTML interface.  Many of the icons on the tool bar can be found on most text editing (word processing) programs. This page will cover some of the icons/tools which may not be as familiar to a new user of Moodle.


For example, you can cut/copy and paste text from other applications into this editor and formatting will be preserved. There is the usual [[Image:Ed paste.gif]] clipboard icon which is for pasting text that has been copied or cut. Or use the usual short cut keys  of Control+C  and Control+V .  
For example, you can cut/copy and paste text from other applications into this editor and formatting will be preserved. There is the usual [[Image:Ed paste.gif]] clipboard icon which is for pasting text that has been copied or cut. Or use the usual short cut keys  of Control+C  and Control+V .  


==HTML editor toolbar features==
[[Image:HTMLeditor_tools_M2_1.png|frame|center|HTML editor toolbar in 2.0. See [[HTML editor 2.0]]]]
[[Image:Course Lesson Page Content Toolbar.GIF|frame|center|HTML editor toolbar in a 1.9.5 Lesson page, other modules will look similar.]]
__TOC__
===Font and background colours===
There are two icons to change the [[Image:Ed color fg.gif]] font and the [[Image:Ed color bg.gif]] colour behind text. Clicking on the icon will bring up a color pallet.  Note the HTML color code is displayed.
[[Image:HTML toolbar Color pallet.JPG|center]]
===Anchor===
[[Image:Ed anchor.gif]] An HTML anchor identifies text within a page which can be referenced by a link. To use the Anchor, highlight the word, then click on the Anchor icon. Give the anchor a name. Anywhere on the page, highlight the word you would like to link to the Anchor. Use the Link icon and the pull down menu to find the correct anchor.
[[Image:HTML toolbar anchor tool.JPG]]
===Inserting links===
[[Image:Ed link.gif|left|]] An HTML link creates a path to an external, internal or within the current page. The icon saves writing code.  One method is to copy the address bar from the location you want, click on the link icon, then paste the URL. Another method is to press the Browse button, which will display the [[Files]] area of the course, from whence you select an existing file or upload a new file and link to that.
'''To make a new link'''
*Type the text that you want to serve as the anchor for your link
***For example: "Link to course file in demo.moodle.org"
*Select the text
***For example select "course file" by highlighting it with your mouse.
*Click the [[Image:Ed link.gif]] link button in the toolbar
*Type (or paste, or browse to) the URL you want to link to
***For example we used "browse", and clicked on the file to get our entry
*Type in some text which will appear when the mouse rolls over it
***For example: "Course file in demo moodle."
*Target - What kind of window should be called up -- typically, open a New window.
***[[Image:HTML editor insert link target menu.jpg]]
*Anchors - A pull down list allows you to select an [[HTML_editor#Anchor|anchor]] you previously created on the page
*Click OK
[[Image:HTML toolbar Hyperlink.JPG|center]]
*After the above steps the student will see:
**[[Image:HTML toolbar Insert Link result1.jpg|frame|center|This result]]


Marketing Unit


a) On a BCG matrix, identify N-Pharma’s product portfolio
* [[Image:Ed unlink.gif]] The unlink, will remove the HTML link from the selected text.
b) What are the benefits of using ‘family branding’?
c) What type of market research methods could N-Pharma have used in East Asia to assess customers’ loyalty to its products?
d) Using relevant marketing concepts such as Ansoff matrix, design a marketing plan aimed at penetrating the Asian veterinary market
e) State and explain two ways in which N-Pharma’s marketing mix might change as a result of the introduction of generic drugs and cheaper substitutes into the market
Marketing Unit


a) On a BCG matrix, identify N-Pharma’s product portfolio
====TIPs - inserting links====
b) What are the benefits of using ‘family branding’?
*This process does '''NOT''' work inside the wiki module where you need to use the Wiki link system (square brackets containing the label and the link separated by a vertical line character)
c) What type of market research methods could N-Pharma have used in East Asia to assess customers’ loyalty to its products?
*A course file has a URL address that can be found via the browse button
d) Using relevant marketing concepts such as Ansoff matrix, design a marketing plan aimed at penetrating the Asian veterinary market
e) State and explain two ways in which N-Pharma’s marketing mix might change as a result of the introduction of generic drugs and cheaper substitutes into the market
Marketing Unit


a) On a BCG matrix, identify N-Pharma’s product portfolio
===Prevent Automatic Linking===
b) What are the benefits of using ‘family branding’?
*  [[Image:Ed nolink.gif]] The prevent automatic linking icon prevents the selected text from being linked to [[Glossary]].  For example, this is useful in a quiz question or where the links are distracting in a presentation.
c) What type of market research methods could N-Pharma have used in East Asia to assess customers’ loyalty to its products?
 
d) Using relevant marketing concepts such as Ansoff matrix, design a marketing plan aimed at penetrating the Asian veterinary market
This also prevents automatic linking to activity or resource pages within the same course if the Resource Names Auto-linking filter has been enabled at Site level.
State and explain two ways in which N-Pharma’s marketing mix might change as a result of the introduction of generic drugs and cheaper substitutes into the market
 
===Inserting images===
[[Image:Ed_image.gif]] Moodle allows you to upload pictures into a course or site folder, then insert that image into the content area.  It is also possible to use an existing image located outside of your Moodle site.
 
You can include images in the content area by using the [[Image:Ed_image.gif]] button. This will bring up an insert image edit screen to assist you in inserting an picture.  More detailed instructions for [[Insert image|inserting an image can be found here]]. Moodle recognizes JPG, GIF and PNG as image files.
[[Image:HTML Insert Image tool pop-up.JPG|thumb|center|300px|[[Insert image| Insert image page link]] in Moodle Documentation]]
 
===Inserting tables===
* [[Image:Insert table.gif]] To add layout to your texts, you can use the "Insert Tables" button in the toolbar.
 
[[Image:HTML toolbar table settings.jpg|center]]
*Most table editing tools are only visible if you click the '''Enlarge Editor''' button.
 
 
===Inserting smilies (emoticons)===
 
The smiley icon [[Image:Smiley.gif]] will allow you to add a small icon (for example [[Image:Cool.gif]] ) in your text. A dialog will pop up that allows you to select from a table of smiley icons. Alternatively, you can just type the corresponding code straight into your text and it will be converted later when your text is displayed.
[[Image:HTML toolbar Smiley icon selections.JPG|center]]
 
===Clean Word button===
The clean Word [[Image:Ed wordclean.gif]] button removes some Word formatting from your pasted text so that the page is smaller, less complex and thus loads faster.  The [http://www.microsoft.com/downloads/details.aspx?FamilyID=209ADBEE-3FBD-482C-83B0-96FB79B74DED&displaylang=EN Microsoft Office HTML Filter 2.0] removes all Word code from HTML file far more effectively for Office 2000. This filter is already built into office in Microsoft Office XP onwards.
 
===Special characters===
The special characters [[Image:special characters button.gif]] button, allows you to enter special characters from a table.
[[Image:HTML_toolbar_Special_character_selections.JPG|center]]
 
===Toggle to HTML Code editing===
 
The [[Image: Ed html.gif]] button changes the display window to raw HTML code. This can be useful for those of you that know how to use it (or want to learn!). Most of the buttons do not work in this view, including many of the hotkeys.
 
[[Image:HTML editor HTML code example.png|thumb|center|400px|Example of HTML code for content area in a forum post ]]
 
===Enlarge editor===
The [[Image:Fullscreen maximize.gif]] button will expand the HTML editor area.
 
===Clean Word button===
The clean Word [[Image:Ed wordclean.gif]] button removes some Word formatting from your pasted text so that the page is smaller, less complex and thus loads faster.  The [http://www.microsoft.com/downloads/details.aspx?FamilyID=209ADBEE-3FBD-482C-83B0-96FB79B74DED&displaylang=EN Microsoft Office HTML Filter 2.0] removes all Word code from HTML file far more effectively for Office 2000. This filter is already built into office in Microsoft Office XP onwards.


==Shortcut keys==
==Shortcut keys==
Line 191: Line 259:
*The HTML editor does not work in all browsers. If you are using a Mac OS X and for some reason it does not appear, try using Firefox instead of Safari as a browser.
*The HTML editor does not work in all browsers. If you are using a Mac OS X and for some reason it does not appear, try using Firefox instead of Safari as a browser.


*Can not make HTML give you the text style you want? Use an image or even an animated gif file.
*To make the switch in Safari in Moodle 1.9:
:#With Safari open, go to Preferences in the Safari menu.
:#Select the Advanced tab.
:#At the bottom of the window, check "Show Develop menu in menu bar"
:#The second item in the Develop menu is "User Agent". Select a version of Firefox and possibly Internet Explorer also works.
 
*Cannot make HTML give you the text style you want? Use an image or even an animated gif file.
 
*It is possible to deploy your own custom smiley (emoticon) set. This is [[deploying_custom_emoticons|described here]].


==See also==  
==See also==  


*[[HTML editor FAQ]]
*[[HTML editor FAQ]]
*[[HTML editor 2.0]]
*[[Page content]] - for more assistance on using some of above editing icons
*[[Page content]] - for more assistance on using some of above editing icons
*[[Insert image]] - examples and instructions for inserting and editing images
*[[Insert image]] - examples and instructions for inserting and editing images
*[[HTML in Moodle]]
*[[HTML in Moodle]]
*[[HTML editor settings]] - change the look of the HTML toolbar
*[[HTML editor settings]] - change the look of the HTML toolbar
*Extend HTMLAREA editor with an extra toolbar, full of useful plugins by using [[htmlarea_custom_plugins]] framework (tiny patch).


Using Moodle forum discussions:
Using Moodle forum discussions:

Revision as of 21:04, 22 May 2011

Note: There is a new HTML editor in Moodle 2.0 onwards. See HTML editor 2.0 for details.


Moodle has a standard toolbar that serves as an HTML interface. Many of the icons on the tool bar can be found on most text editing (word processing) programs. This page will cover some of the icons/tools which may not be as familiar to a new user of Moodle.

For example, you can cut/copy and paste text from other applications into this editor and formatting will be preserved. There is the usual Ed paste.gif clipboard icon which is for pasting text that has been copied or cut. Or use the usual short cut keys of Control+C and Control+V .

HTML editor toolbar features

HTML editor toolbar in 2.0. See HTML editor 2.0
HTML editor toolbar in a 1.9.5 Lesson page, other modules will look similar.


Font and background colours

There are two icons to change the Ed color fg.gif font and the Ed color bg.gif colour behind text. Clicking on the icon will bring up a color pallet. Note the HTML color code is displayed.

HTML toolbar Color pallet.JPG

Anchor

Ed anchor.gif An HTML anchor identifies text within a page which can be referenced by a link. To use the Anchor, highlight the word, then click on the Anchor icon. Give the anchor a name. Anywhere on the page, highlight the word you would like to link to the Anchor. Use the Link icon and the pull down menu to find the correct anchor. HTML toolbar anchor tool.JPG

Inserting links

Ed link.gif

An HTML link creates a path to an external, internal or within the current page. The icon saves writing code. One method is to copy the address bar from the location you want, click on the link icon, then paste the URL. Another method is to press the Browse button, which will display the Files area of the course, from whence you select an existing file or upload a new file and link to that.

To make a new link

  • Type the text that you want to serve as the anchor for your link
      • For example: "Link to course file in demo.moodle.org"
  • Select the text
      • For example select "course file" by highlighting it with your mouse.
  • Click the Ed link.gif link button in the toolbar
  • Type (or paste, or browse to) the URL you want to link to
      • For example we used "browse", and clicked on the file to get our entry
  • Type in some text which will appear when the mouse rolls over it
      • For example: "Course file in demo moodle."
  • Target - What kind of window should be called up -- typically, open a New window.
      • HTML editor insert link target menu.jpg
  • Anchors - A pull down list allows you to select an anchor you previously created on the page
  • Click OK
HTML toolbar Hyperlink.JPG
  • After the above steps the student will see:
    • This result


  • Ed unlink.gif The unlink, will remove the HTML link from the selected text.

TIPs - inserting links

  • This process does NOT work inside the wiki module where you need to use the Wiki link system (square brackets containing the label and the link separated by a vertical line character)
  • A course file has a URL address that can be found via the browse button

Prevent Automatic Linking

  • Ed nolink.gif The prevent automatic linking icon prevents the selected text from being linked to Glossary. For example, this is useful in a quiz question or where the links are distracting in a presentation.

This also prevents automatic linking to activity or resource pages within the same course if the Resource Names Auto-linking filter has been enabled at Site level.

Inserting images

Ed image.gif Moodle allows you to upload pictures into a course or site folder, then insert that image into the content area. It is also possible to use an existing image located outside of your Moodle site.

You can include images in the content area by using the Ed image.gif button. This will bring up an insert image edit screen to assist you in inserting an picture. More detailed instructions for inserting an image can be found here. Moodle recognizes JPG, GIF and PNG as image files.

Insert image page link in Moodle Documentation

Inserting tables

  • Insert table.gif To add layout to your texts, you can use the "Insert Tables" button in the toolbar.
HTML toolbar table settings.jpg
  • Most table editing tools are only visible if you click the Enlarge Editor button.


Inserting smilies (emoticons)

The smiley icon Smiley.gif will allow you to add a small icon (for example Cool.gif ) in your text. A dialog will pop up that allows you to select from a table of smiley icons. Alternatively, you can just type the corresponding code straight into your text and it will be converted later when your text is displayed.

HTML toolbar Smiley icon selections.JPG

Clean Word button

The clean Word Ed wordclean.gif button removes some Word formatting from your pasted text so that the page is smaller, less complex and thus loads faster. The Microsoft Office HTML Filter 2.0 removes all Word code from HTML file far more effectively for Office 2000. This filter is already built into office in Microsoft Office XP onwards.

Special characters

The special characters special characters button.gif button, allows you to enter special characters from a table.

HTML toolbar Special character selections.JPG

Toggle to HTML Code editing

The Ed html.gif button changes the display window to raw HTML code. This can be useful for those of you that know how to use it (or want to learn!). Most of the buttons do not work in this view, including many of the hotkeys.

Example of HTML code for content area in a forum post

Enlarge editor

The Fullscreen maximize.gif button will expand the HTML editor area.

Clean Word button

The clean Word Ed wordclean.gif button removes some Word formatting from your pasted text so that the page is smaller, less complex and thus loads faster. The Microsoft Office HTML Filter 2.0 removes all Word code from HTML file far more effectively for Office 2000. This filter is already built into office in Microsoft Office XP onwards.

Shortcut keys

Here are some common editing short cut or hot keys which will within the HTML editor in WYSIWYG view. Different operating systems and browsers may not support all these keys. The most universal hot keys are in bold.

Keys Action Keys Action
Ctrl-C Copy Ctrl-V Paste
Ctrl-X Cut Ctrl-F Find text
Ctrl-H Find and replace * *
Ctrl-Z Undo Ctrl-Y Redo
Ctrl-B Make text bold Ctrl-I Make text italic
Ctrl-U Underline text Ctrl-S Strikethrough text
Ctrl-H Change text format (headings etc.) Ctrl-1 to Ctrl-6 Change heading level
Ctrl-, Subscript Ctrl-. Superscript
Ctrl-O Change the font Ctrl-0 Clean Word HTML
Ctrl-L Justify left Ctrl-E Center
Ctrl-J Justify full Ctrl-/ Text runs left to right
Ctrl-| Text runs right to left Ctrl-; Decrease indent
Ctrl-' Increase indent Ctrl-G Change text colour
Ctrl-K Change background colour Ctrl-P Change the font size
Ctrl-` Switch to HTML source code view Ctrl-M Toggle fullscreen editor mode
Ctrl-Alt-O Insert ordered list Ctrl-Alt-U Insert unordered list
Ctrl-Alt-R Insert horizontal rule Ctrl-Alt-A Create anchor
Ctrl-Alt-L Create link Ctrl-Alt-D Unlink
Ctrl-Alt-N Turn off autolinking Ctrl-Alt-I Insert image
Ctrl-Alt-T Insert table Ctrl-Alt-S Insert emoticon
Ctrl-Alt-C Insert special character Ctrl-= Change text language for screen readers, or specify language for the Multilang filter

Tips and Tricks

  • Theme settings can control the default fonts in the HTML editor. It is possible to have individual themes for a context (for example, a course may have its own theme).
  • When you choose many functions a new small window will open. Unfortunately it can often open BEHIND the window you are in so you may miss that anything has happened. You can check new windows with [Alt]+[Tab].
  • The HTML editor does not work in all browsers. If you are using a Mac OS X and for some reason it does not appear, try using Firefox instead of Safari as a browser.
  • To make the switch in Safari in Moodle 1.9:
  1. With Safari open, go to Preferences in the Safari menu.
  2. Select the Advanced tab.
  3. At the bottom of the window, check "Show Develop menu in menu bar"
  4. The second item in the Develop menu is "User Agent". Select a version of Firefox and possibly Internet Explorer also works.
  • Cannot make HTML give you the text style you want? Use an image or even an animated gif file.
  • It is possible to deploy your own custom smiley (emoticon) set. This is described here.

See also

Using Moodle forum discussions: