Help/How-to-Write-a-Language-Lesson

From Polyglot Club WIKI
Jump to: navigation, search

Logo WIKI3.png « Share your Knowledge of Languages » Why? - How?


Write a lesson: Why? How?

Here are some tips to help you create a language learning lesson:

The Wiki page editing is done thanks to the MediaWiki Engine, the software used by the famous Wikipedia.

What editor choose?[edit | edit source]

You have two options:

Visual Editor[edit | edit source]

If you are new at Wiki page editing, we recommend using the visual editor. It is an editor WYSIWYG who is proposed by default.

Creating pages is intuitive with the various buttons to format the text.

Wiki Code[edit | edit source]

If you have a little more experience, we advise you to directly use the Wiki code because you have more formatting options.

Useful Wiki Codes[edit | edit source]

Here are some useful markups :

Links[edit | edit source]

Internal links[edit | edit source]

To link to a page which URL is wiki/Help inside the Polyglot club wiki, use the following code:

[[Help|different text]]

External links[edit | edit source]

To link to a page outside Polyglot club wiki.

[https://mediawiki.org MediaWiki]

Images[edit | edit source]

Example:

[[File:My_pic.png|thumb|none]] Align left

Onomatopoeias.png

[[File:My_pic.png|thumb]] Align right

[[File:My_pic.png|thumb|My Picture Caption]] with a caption

Videos[edit | edit source]

To add a Youtube video, simply circle the video ID like this:

<youtube>[ID code]</youtube>

The video [ID code] can be found inside the URL of a Youtube video.

Example:

if the URL is as follows: https://www.youtube.com/watch?v=S4ypgbP2Jn4&app=desktop

The code to copy is S4ypgbP2Jn4 (between v= and &)

After inserting the following code:

<youtube> S4ypgbP2Jn4 </youtube>

the video appears as below:

Audio MP3 files[edit | edit source]

When writing a lesson to learn a language, it is cool to be able to add, next to a word, a small MP3 player to hear the pronunciation of that word.

Better an example than a long explanation:

Alligator.png

Alligator

To know how to do this, read THIS PAGE.

Lists[edit | edit source]

Bullet list[edit | edit source]

*item 1

*item 2

The result is as followed:

  • item 1
  • item 2

Bullet list 2[edit | edit source]

*item 1

**item 12

The result is as followed:

  • item 1
    • item 12

Numbered List[edit | edit source]

:#item 1

:#item 2

The result is as followed:

  1. item 1
  2. item 2

Numbered List 2[edit | edit source]

#item 1

##item 12

#item 2

##item 22

The result is as followed:

  1. item 1
    1. item 12
  2. item 2
    1. item 21

Headings[edit | edit source]

To organize your lesson, and for Search engine optimization, it is good to use different levels of headings: h2, h3...

Use Heading2 (h2) and within each Heading2, you can use Headings3 (h3) and so on: Heading4, Heading5 etc...

Do not use Heading1 because this heading is already used for the page title and we can have only one Heading1 per page.

For h2, use the following code :

==Vocabulary==

For h3, use the following code:

===The farm animals===

Tables[edit | edit source]

Here are easy ways to create large tables without having to use the wiki code or the visual editor:

Create a table: Solution1[edit | edit source]

  1. Create your table in Excel
  2. Use this free tool to create the wiki code equivalent to your Excel table
  3. Edit the wiki page with the "Edit source" tab
  4. Paste the code

Create a table: Solution2[edit | edit source]

  1. Create the table in Excel
  2. Copy and Paste the table in the page with the Visual Editor mode (do not use the "Edit source" table but use the "Edit" table)
  3. Save the page
  4. Edit the page, this time, with the "Edit source" tab
  5. At the top of the table, add the following code, this will make your table much nicer

Replace the line : {| By the line : {| class="wikitable"

Update a table[edit | edit source]

  1. Copy the table from the html page
  2. Paste in Excel
  3. Edit your table in Excel

Then update the wiki page, using solution 1 or 2 above

Page Structures Example[edit | edit source]

Here is an example of page structure:

(image)

Vocabulary for animals in English (title of the page in bold)

==Vocabulary==(h2)

===The farm animals===(h3)

===Pets=== (h3)

==Expressions== (h2)

==Videos== (h2)

Examples[edit | edit source]

Here are examples of existing lessons to inspire you:

Write a lesson: Why? How?

Contributors

Vincent and 176.151.92.12

Last Lessons

Create a new Lesson