Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Adding/editing a glossary.

Adding/editing a glossary: Difference between revisions

From MoodleDocs
No edit summary
(→‎Glossary type: removing misleading reference to teachers editing main glossary)
 
(32 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Adding a new glossary to the course, you will define several fields, beginning with the most straightforward ones: '''''Name''''' and '''''Description''''' (where you should describe the purpose of the glossary, provide instructions or background information, links etc.).  
{{Glossaries}}
==Adding a glossary==
[[Image:adding glossary.png|thumb|Adding a glossary]]
To add a glossary:
#Click the "Turn editing on" button.
#Select Glossary from the "Add an activity" dropdown menu.
#On the Adding a new glossary page give your new glossary a descriptive name.
#Describe the purpose of the glossary, provide instructions or background information, links etc. in the Description area.
#Select the general and grade options and the common module settings (see below).
#Click the "Save changes" button at the bottom of the page.
__TOC__


==General options==


'''''Entries shown per page''''' defines the number of entries shown per page. The glossary can be configured to restrict the number of entries shown per page. If you have a large number of automatically-linked entries you should set this number lower to prevent long loading times.
===Entries shown per page===


This sets the number of words and definitions that students will see when they view the glossary list. If you have a large number of automatically-linked entries you should set this number lower to prevent long loading times.


===Is this glossary global?===


Administrators can define a glossary to be global.
Administrators can make a global glossary, with entries linking throughout the whole Moodle site. Any course may contain a global glossary, though the best practice is to place a global glossary on the site front page.
These glossaries can be part of any course (but particularly the front page).
The difference to a normal local glossary is that the entries are used to create automatic links throughout the whole site (and not just in the same course the glossary belongs to).


===Glossary type===


Here you can decide whether the glossary will be main or secondary. The glossary system allows you to export entries from any secondary glossary to the main one of the course. In order to do this, you should specify which glossary is the main one. You can only have one main glossary per course.


Defining the main glossary of the course
===Students can add entries===
The glossary system allows you to export entries from any secondary glossary to the main one of the course.
In order to do this, you should specify which glossary is the main one.
Note: You can only have one main glossary per course and only teachers are allowed to update it.


Prior to Moodle 1.7, you can specify whether a student may add, edit or delete their own entries. Entries exported to a main glossary can be updated or deleted by teachers only, so this setting only applies to secondary glossaries. (A teacher can edit or delete any entry at any time.)


Approved by default
Note: From Moodle 1.7 onwards, this option has been replaced with a role override and preventing the capability [[Capabilities/mod/glossary:write|mod/glossary:write]].
This setting allows the teacher to define what happens to new entries added by students. They can be automatically made available to everyone, otherwise the teacher will have to approve each one.


===Duplicated entries allowed===


Allow duplicated entries
This allows the entry of more than one definition for a given word.
If you turn this option on, then multiple entries are allowed to use the same concept name.


===Allow comments on entries===


Students and teachers can leave comments on glossary definitions. The comments are available through a link at the bottom of the definition.


Students can post entries
===Allow print view===
You can specify whether a student can or cannot add, edit or delete his/her own entries. Entries exported to a main glossary can be updated or deleted by teachers only, so this setting only applies to secondary glossaries.
Note: A teacher can edit or delete any entry at any time.


Allow comments on entries
This provides a printer-friendly version link for students. (Teachers are always provided with a printer-friendly version link.)
Students can be allowed to add comments to glossary entries.
You can choose whether this feature is enabled or disabled.
Teachers always can add comments to glossary entries.


Display format
===Automatically link glossary entries===


This setting specifies the way that each entry will be shown within the glossary. The default formats are:
If site-wide glossary auto-linking is enabled by an administrator (see [[Filters]] for further details), then turning this on allows individual entries in this glossary to be automatically linked whenever the concept words and phrases appear throughout the rest of the same course. This includes forum postings, internal resources, week summaries and so on.
Simple Dictionary:
looks like a conventional dictionary with separate entries. No authors are displayed and attachments are shown as links.
Continuous:
shows the entries one after other without any kind of separation but the editing icons.  
Full with Author:
A forum-like display format showing author's data. Attachments are shown as links.
Full without Author:
A forum-like display format that does not show author's data. Attachments are shown as links.
Encyclopedia:
Like 'Full with Author' but attached images are shown inline.
FAQ:
Useful for displaying lists of Frequently Asked Questions. It automatically appends the words QUESTION and ANSWER in the concept and definition respectively.


Note: Enabling linking for the glossary does not automatically turn on linking for each entry - linking needs to be set for each entry individually. If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text. Note that category names are also linked.


Defining the number of entries shown per page
===Approved by default===
The glossary can be configured to restrict the number of entries shown per page.
If you have a large number of automatically-linked entries you should set this number lower to prevent long loading times.


That allows the teacher to define what happens to new entries added by students. They can be automatically made available to everyone, otherwise the teacher will have to approve each one.


Browsing options in Alphabet Display
===Display format===
You can customize the way a user can browse a glossary. Browsing and searching are always available, but you can define three more options:
 
SHOW SPECIAL Enable or disable browsing by special characters like @, #, etc.
That specifies the way that each entry will be shown within the glossary. The default formats are:
SHOW ALPHABET Enable or disable browsing by alphabetic letters.
 
SHOW ALL Enable or disable browsing of all entries at once.
* Simple, dictionary style - This looks like a conventional dictionary with separate entries. No authors are displayed and attachments are shown as links.
* Continuous without author - That shows the entries one after other without any kind of separation but the editing icons.
* Full with author - A forum-like display format showing author's data. Attachments are shown as links.
* Full without author - A forum-like display format that does not show author's data. Attachments are shown as links.
* Encyclopedia - Like 'Full with author' but attached images are shown inline.
* Entry list - This lists the concepts as links.
* FAQ  - Useful for displaying lists of frequently asked questions. It automatically appends the words QUESTION and ANSWER in the concept and definition respectively.
 
 
The table below summarises the different display formats.
<table style="text-align: center;" border="1" cellpadding="2" cellspacing="0">
  <tr>
    <th style="text-align: left; width: 15em;">Format</th>
    <th style="width: 4em;">Entry</th>
    <th style="width: 4em;">Author</th>
    <th style="width: 4em;">Date</th>
 
    <th style="width: 4em;">Definition</th>
    <th style="width: 4em;">Images</th>
    <th style="width: 4em;">Attachments</th>
  </tr>
  <tr>
    <td style="text-align: left;">Entry list</td>
    <td>x</td>
 
    <td>- </td>
    <td>-</td>
    <td>x*</td>
    <td>x*</td>
    <td>link*</td>
  </tr>
 
  <tr>
    <td style="text-align: left;">Simple Dictionary</td>
    <td>x</td>
    <td>-</td>
    <td>-</td>
    <td>x</td>
 
    <td>x</td>
    <td>link</td>
  </tr>
  <tr>
    <td style="text-align: left;">Continuous</td>
    <td>x</td>
    <td>-</td>
 
    <td>-</td>
    <td>x</td>
    <td>x</td>
    <td>link</td>
  </tr>
  <tr>
    <td style="text-align: left;">FAQ</td>


    <td>x</td>
    <td>-</td>
    <td>x</td>
    <td>x</td>
    <td>x</td>
    <td>link</td>


Enabling automatic linking in a glossary
  </tr>
Turning this feature on will allow individual entries in this glossary to be automatically linked whenever the concept words and phrases appear throughout the rest of the same course. This includes forum postings, internal resources, week summaries and so on.
  <tr>
Note that enabling linking for the glossary does not automatically turn on linking for each entry - linking needs to be set for each entry individually.
    <td style="text-align: left;">Full without Author</td>
If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text.
    <td>x</td>
Note that category names are also linked.
    <td>-</td>
    <td>x</td>
    <td>x</td>


    <td>x</td>
    <td>link</td>
  </tr>
  <tr>
    <td style="text-align: left;">Full with Author</td>
    <td>x</td>
    <td>x</td>


File to import
    <td>x</td>
Select the XML file on your own computer which contains the entries to import.
    <td>x</td>
    <td>x</td>
    <td>link</td>
  </tr>
  <tr>
    <td style="text-align: left;">Encyclopedia</td>


    <td>x</td>
    <td>x</td>
    <td>x</td>
    <td>x</td>
    <td>x</td>
    <td>x**</td>


  </tr>
</table>
<p>* Will be shown in a pop-up window.</p>
<p>* * Attached images are shown inline.</p>


Importing categories
===Browsing options in alphabet display===
By default, all the entries will be imported. You can specify if you want the categories to be imported as well (and the new entries will be assigned to these).


Defining the destination of imported entries
You can customize the way a user can browse a glossary. Browsing and searching are always available, but you can define three more options:
You can specify where you want to import entries to:
* Show "Special" link - Enable or disable browsing by special characters like @, #, etc.
Current Glossary: Will append the imported entries to the currently open glossary.  
* Show alphabet - Enable or disable browsing by alphabetic letters.
New Glossary: Will create a new glossary based on the information found in the selected import file and will insert the new entries into it.  
* Show "All" link - Enable or disable browsing of all entries at once.


===Edit always===
If you want entries to be always editable, set this to Yes.


RSS feed for this glossary
==Grade options==
This option allows you to enable RSS feeds from this glossary.
You can select between two types of feeds:
With author: Generated feeds will include the name of the author in every article.
Without author: Generated feeds won't include the name of the author in every article.


===Allow entries to be rated===


Number of RSS recent articles
You can grade entries yourself or allow students to grade entries as well. Select "Only teachers" or "Everyone" from the users menu. Then select a grading scale. You can also restrict when entries can be graded to a specific date range.  
This option allows you to select the number of articles to include in the RSS Feed.
A number between 5 and 20 would be normal for most glossaries. Increase the number if the glossary is updated frequently.


==Common module settings==


Enabling automatic linking in a entry
===Group mode===
Turning this feature on will allow the entry to be automatically linked, whenever the concept words and phrases appear throughout the rest of the same course. This includes forum postings, internal resources, week summaries and so on.
If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text.
To be able to turn on this feature, auto linking must be enabled at glossary level.


Another location to set the group mode for the activity. If group mode is forced in the course settings then this setting will be ignored.


Keywords
===Visible to students===
Each entry in the glossary can have an associated list of keywords (or aliases).
Enter each alias on a new line (not separated by commas).
The aliased words and phrases can be used as alternative ways to refer to the entry. For example, if you are using the glossary auto-linking filter then the aliases will be used (as well as the main name of the entry) when deciding what words to link to this entry.


You can also decide on whether or not the glossary will be seen by the students. You can hide the activity from students by selecting 'Hide'. It is useful if you don't want to make the activity available immediately.


Case sensitive matching
==See also==
This setting specifies whether matching exact upper and lower case is necessary when performing automatic linking to these entries.
For example, if this is turned on, then a word like "html" in a forum posting will NOT be linked to a glossary entry called "HTML".


*[http://www.youtube.com/watch?v=1b2FHIrK5S8 Video showing how to create a glossary]


Whole words matching
[[cs:Přidání/úprava_slovníku]]
If automatic linking is enabled, then turning this setting on will force only whole words to be linked.
[[de:Glossar_anlegen]]
For example, a glossary entry named "construct" will not create a link inside the word "constructivism".
[[fr:Ajouter/Éditer un glossaire]]
[[ja:用語集を追加/編集する]]

Latest revision as of 08:53, 26 April 2010


Adding a glossary

Adding a glossary

To add a glossary:

  1. Click the "Turn editing on" button.
  2. Select Glossary from the "Add an activity" dropdown menu.
  3. On the Adding a new glossary page give your new glossary a descriptive name.
  4. Describe the purpose of the glossary, provide instructions or background information, links etc. in the Description area.
  5. Select the general and grade options and the common module settings (see below).
  6. Click the "Save changes" button at the bottom of the page.

General options

Entries shown per page

This sets the number of words and definitions that students will see when they view the glossary list. If you have a large number of automatically-linked entries you should set this number lower to prevent long loading times.

Is this glossary global?

Administrators can make a global glossary, with entries linking throughout the whole Moodle site. Any course may contain a global glossary, though the best practice is to place a global glossary on the site front page.

Glossary type

Here you can decide whether the glossary will be main or secondary. The glossary system allows you to export entries from any secondary glossary to the main one of the course. In order to do this, you should specify which glossary is the main one. You can only have one main glossary per course.

Students can add entries

Prior to Moodle 1.7, you can specify whether a student may add, edit or delete their own entries. Entries exported to a main glossary can be updated or deleted by teachers only, so this setting only applies to secondary glossaries. (A teacher can edit or delete any entry at any time.)

Note: From Moodle 1.7 onwards, this option has been replaced with a role override and preventing the capability mod/glossary:write.

Duplicated entries allowed

This allows the entry of more than one definition for a given word.

Allow comments on entries

Students and teachers can leave comments on glossary definitions. The comments are available through a link at the bottom of the definition.

Allow print view

This provides a printer-friendly version link for students. (Teachers are always provided with a printer-friendly version link.)

Automatically link glossary entries

If site-wide glossary auto-linking is enabled by an administrator (see Filters for further details), then turning this on allows individual entries in this glossary to be automatically linked whenever the concept words and phrases appear throughout the rest of the same course. This includes forum postings, internal resources, week summaries and so on.

Note: Enabling linking for the glossary does not automatically turn on linking for each entry - linking needs to be set for each entry individually. If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text. Note that category names are also linked.

Approved by default

That allows the teacher to define what happens to new entries added by students. They can be automatically made available to everyone, otherwise the teacher will have to approve each one.

Display format

That specifies the way that each entry will be shown within the glossary. The default formats are:

  • Simple, dictionary style - This looks like a conventional dictionary with separate entries. No authors are displayed and attachments are shown as links.
  • Continuous without author - That shows the entries one after other without any kind of separation but the editing icons.
  • Full with author - A forum-like display format showing author's data. Attachments are shown as links.
  • Full without author - A forum-like display format that does not show author's data. Attachments are shown as links.
  • Encyclopedia - Like 'Full with author' but attached images are shown inline.
  • Entry list - This lists the concepts as links.
  • FAQ - Useful for displaying lists of frequently asked questions. It automatically appends the words QUESTION and ANSWER in the concept and definition respectively.


The table below summarises the different display formats.

Format Entry Author Date Definition Images Attachments
Entry list x - - x* x* link*
Simple Dictionary x - - x x link
Continuous x - - x x link
FAQ x - x x x link
Full without Author x - x x x link
Full with Author x x x x x link
Encyclopedia x x x x x x**

* Will be shown in a pop-up window.

* * Attached images are shown inline.

Browsing options in alphabet display

You can customize the way a user can browse a glossary. Browsing and searching are always available, but you can define three more options:

  • Show "Special" link - Enable or disable browsing by special characters like @, #, etc.
  • Show alphabet - Enable or disable browsing by alphabetic letters.
  • Show "All" link - Enable or disable browsing of all entries at once.

Edit always

If you want entries to be always editable, set this to Yes.

Grade options

Allow entries to be rated

You can grade entries yourself or allow students to grade entries as well. Select "Only teachers" or "Everyone" from the users menu. Then select a grading scale. You can also restrict when entries can be graded to a specific date range.

Common module settings

Group mode

Another location to set the group mode for the activity. If group mode is forced in the course settings then this setting will be ignored.

Visible to students

You can also decide on whether or not the glossary will be seen by the students. You can hide the activity from students by selecting 'Hide'. It is useful if you don't want to make the activity available immediately.

See also