This is a test site. Any changes will be lost!

HTML editor: Difference between revisions

From MoodleDocs
m Reverted edits by Frierdsterlogin (talk); changed back to last version by Samuli Karevaara
 
(67 intermediate revisions by 11 users not shown)
Line 1: Line 1:
The Richtext HTML editor provides a word-processor interface embedded in your web page to allow you to edit text in an intuitive way, and produces normal HTML code.
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.


In addition to formatting text, this editor provides a number of extra features you may find useful.
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 .  


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].


==HTML editor toolbar==
==HTML editor toolbar features==
[[Image:Course Lesson Page Content Toolbar.GIF|frame|center|HTML editor toolbar in a Lesson page]]
[[Image:Course Lesson Page Content Toolbar.GIF|frame|center|HTML editor toolbar in a Lesson page, other modules will look similar.]]
==Paste text in from other applications==


*You can cut and paste rich text from other Windows applications such as Microsoft Word straight into this editor, and your formatting will be preserved. Just use the normal cut and paste menus in your web browser (or Control-C and Control-V).
   
*'''Clean Word HTML 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. This filter is already built into office in Microsoft Office XP onwards.


==Inserting images==
__TOC__


If you have images that are already published on a web site and accessible via a URL, you can include these images in your texts using the "[[Page_content#Image_Insertion|Insert Image]]" button. Moodle recongizes JPG, GIF and PNG as image files.
===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]]


==Inserting tables==
===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]]


*To add layout to your texts, you can use the "Insert Tables" button in the toolbar.
===Inserting links===
[[Image:Ed link.gif|left|]] An HTML link creates a path to external, internal or 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 it URL. Another method is to press the Browse button.  This will take you to the [[Files]] area of the course.  From here it is possible to select an existing file or to upload a new file and link to it.
 
'''To make a new link'''
*Type the text that you want to be a 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 browsed 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
***[[Image:HTML editor insert link target menu.jpg]]
*Anchors - A pull down list allows you to select an [[HTML_editor#Anchor|anchor]] you 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]]
 
 
====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
 
===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.
*Most table editing tools are only visible if you click the '''Enlarge Editor''' button.


==Inserting links==


To make a new link,
===Inserting smilies (emoticons)===
*type the text that you want to be a link
 
*select the text
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.
*click the link button in the toolbar
[[Image:HTML toolbar Smiley icon selections.JPG|center]]
*Type (or paste, or browse to) the URL you want to link to
 
*Click OK
===Special characters===
NOTE: 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 seperated by a vertical line character)
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 ]]


==Inserting smilies (emoticons)==
===Enlarge editor===
The [[Image:Fullscreen maximize.gif]] button will expand the HTML editor area.


To embed these small icons in your text, click on the smiley icon in the toolbar. A dialog will pop up that allows you to select from the following 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).
===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. This filter is already built into office in Microsoft Office XP onwards.


==Shortcut keys==
==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'''.
{|  border="0" cellpadding="2" cellspacing="0" style="text-align:left"
! width="70"|Keys
! width="300"|Action
! width="10"|
! width="70"|Keys
! width="300"|Action


{| class="wikitable" style="text-align:center"
|-
! Keys
! Action
|-
|-
| Ctrl-O
| '''Ctrl-C'''
| Change the font
| Copy 
|
| '''Ctrl-V'''
| Paste


|-
|-
| Ctrl-P
| '''Ctrl-X'''
| Change the font size
| Cut
|
| '''Ctrl-F'''
| Find text


|-
|-
| Ctrl-H
| Ctrl-H
| Change text format (headings etc.)
| Find and replace
|
| *
| *


|-
|-
| Ctrl-1
| '''Ctrl-Z'''
| to Ctrl-6 Change heading level
| Undo
 
|
|-
| '''Ctrl-Y'''
| Ctrl-=
| Redo
| Change text language for screen readers, or specify language for the Multilang filter


|-
|-
| Ctrl-B
| '''Ctrl-B'''
| Make text bold  
| Make text bold  
 
|
|-
| '''Ctrl-I'''
| Ctrl-I
| Make text italic  
| Make text italic  


|-
|-
| Ctrl-U
| '''Ctrl-U'''
| Underline text  
| Underline text  
|
| '''Ctrl-S'''
| Strikethrough text


|-
|-
| Ctrl-S
| Ctrl-H
| Strikethrough text  
| Change text format (headings etc.)
|
| Ctrl-1
| to Ctrl-6 Change heading level


|-
|-
| Ctrl-,
| Ctrl-,
| Subscript  
| Subscript  
 
|
|-
| Ctrl-.
| Ctrl-.
| Superscript  
| Superscript  


|-
|-
| Ctrl-O
| Change the font
|
| Ctrl-0
| Ctrl-0
| Clean Word HTML  
| Clean Word HTML  
|-
| Ctrl-Z
| Undo
|-
| Ctrl-Y
| Redo


|-
|-
| Ctrl-L
| Ctrl-L
| Justify left  
| Justify left  
 
|
|-
| Ctrl-E
| Ctrl-E
| Center  
| Center  
Line 109: Line 163:
| Ctrl-J
| Ctrl-J
| Justify full  
| Justify full  
 
|
|-
| Ctrl-/
| Ctrl-/
| Text runs left to right  
| Text runs left to right  
Line 117: Line 170:
| Ctrl-<nowiki>|</nowiki>
| Ctrl-<nowiki>|</nowiki>
| Text runs right to left  
| Text runs right to left  
 
|
|-
| Ctrl-;
| Ctrl-;
| Decrease indent  
| Decrease indent  
Line 125: Line 177:
| Ctrl-'
| Ctrl-'
| Increase indent  
| Increase indent  
 
|
|-
| Ctrl-G
| Ctrl-G
| Change text colour  
| Change text colour  
Line 133: Line 184:
| Ctrl-K
| Ctrl-K
| Change background colour  
| Change background colour  
 
|
|-
| Ctrl-P
| Ctrl-F
| Change the font size
| Search and replace


|-
|-
| Ctrl-`
| Ctrl-`
| Switch to HTML source code view  
| Switch to HTML source code view  
 
|
|-
| Ctrl-M
| Ctrl-M
| Toggle fullscreen editor mode  
| Toggle fullscreen editor mode  
Line 149: Line 198:
| Ctrl-Alt-O
| Ctrl-Alt-O
| Insert ordered list  
| Insert ordered list  
 
|
|-
| Ctrl-Alt-U
| Ctrl-Alt-U
| Insert unordered list  
| Insert unordered list  
Line 157: Line 205:
| Ctrl-Alt-R
| Ctrl-Alt-R
| Insert horizontal rule  
| Insert horizontal rule  
 
|
|-
| Ctrl-Alt-A
| Ctrl-Alt-A
| Create anchor  
| Create anchor  
Line 165: Line 212:
| Ctrl-Alt-L
| Ctrl-Alt-L
| Create link  
| Create link  
 
|
|-
| Ctrl-Alt-D
| Ctrl-Alt-D
| Unlink  
| Unlink  
Line 173: Line 219:
| Ctrl-Alt-N
| Ctrl-Alt-N
| Turn off autolinking  
| Turn off autolinking  
 
|
|-
| Ctrl-Alt-I
| Ctrl-Alt-I
| Insert image  
| Insert image  
Line 181: Line 226:
| Ctrl-Alt-T
| Ctrl-Alt-T
| Insert table  
| Insert table  
 
|
|-
| Ctrl-Alt-S
| Ctrl-Alt-S
| Insert emoticon  
| Insert emoticon  
Line 189: Line 233:
| Ctrl-Alt-C
| Ctrl-Alt-C
| Insert special character  
| Insert special character  
|
| Ctrl-=
| Change text language for screen readers, or specify language for the Multilang filter


|}
|}


==Code editing==
==Tips and Tricks==
*[[Themes|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).


The [<>] 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 there, not even the Search and Replace unfortunately.  
*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.
 
*Can not make HTML give you the text style you want?  Use an image or even an animated gif file.


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


*[[HTML editor FAQ]]
*[[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
*[[HTML in Moodle]]
*[[HTML in Moodle]]
*[[Editor settings]]
*[[HTML editor settings]] - change the look of the HTML toolbar
*Using Moodle [http://moodle.org/mod/forum/view.php?id=1035 HTML editor forum]
 
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=64354 Question about insert image function in HTML editor] forum discussion, including methods of enabling students to insert images using the HTML editor
Using Moodle forum discussions:
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=66805 Need to display english special phonetic symbols for ESL students] forum discussion
*[http://moodle.org/mod/forum/discuss.php?d=64354 Question about insert image function in HTML editor] including methods of enabling students to insert images using the HTML editor
*[http://moodle.org/mod/forum/discuss.php?d=66805 Need to display english special phonetic symbols for ESL students]
*[http://moodle.org/mod/forum/discuss.php?d=83115 tables in HTML editor]


[[Category:Teacher]]
[[Category:HTML editor]]


[[fr:Éditeur WYSIWYG]]
[[fr:Éditeur HTML]]
[[ja:HTMLエディタ]]
[[pl:Edytor_HTML]]

Latest revision as of 09:59, 23 November 2008

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 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 a Lesson page, other modules will look similar.


Font and background colours

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

Anchor

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.

Inserting links

An HTML link creates a path to external, internal or 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 it URL. Another method is to press the Browse button. This will take you to the Files area of the course. From here it is possible to select an existing file or to upload a new file and link to it.

To make a new link

  • Type the text that you want to be a 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 link button in the toolbar
  • Type (or paste, or browse to) the URL you want to link to
      • For example we used browsed 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
  • Anchors - A pull down list allows you to select an anchor you created on the page
  • Click OK
  • After the above steps the student will see:
    • This result


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

Inserting images

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 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

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


Inserting smilies (emoticons)

The smiley icon will allow you to add a small icon (for example ) 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.

Special characters

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

Toggle to HTML Code editing

The 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 button will expand the HTML editor area.

Clean Word button

The clean Word 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. 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.
  • Can not make HTML give you the text style you want? Use an image or even an animated gif file.

See also

Using Moodle forum discussions: