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

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
{{Help-menu}}
{{Help-menu}}
<div class="pg_page_title">How to create a language learning lesson</div>
 
<span style="font-size:200%">'''Here are some tips to help you create a language learning lesson:'''</span>


The Wiki page editing is done thanks to the [https://www.mediawiki.org MediaWiki Engine], the software used by the famous [https://www.wikipedia.org Wikipedia].
The Wiki page editing is done thanks to the [https://www.mediawiki.org MediaWiki Engine], the software used by the famous [https://www.wikipedia.org Wikipedia].
Line 8: Line 9:
===  Visual Editor ===
===  Visual Editor ===
If you are new at Wiki page editing, we recommend using the visual editor which is a [https://en.wikipedia.org/wiki/WYSIWYG WYSIWYG] editor.
If you are new at Wiki page editing, we recommend using the visual editor which is a [https://en.wikipedia.org/wiki/WYSIWYG WYSIWYG] editor.
Click the Actions > '''Edit''' button.


Creating pages is intuitive with the various buttons to format the text.
Creating pages is intuitive with the various buttons to format the text.
Line 17: Line 16:
===  Wiki Code ===
===  Wiki Code ===
If you have a little more experience, we advise you to directly use the Wiki code because you have more formatting options.
If you have a little more experience, we advise you to directly use the Wiki code because you have more formatting options.
Click the Actions > '''Edit Source''' button.


*[https://www.mediawiki.org/wiki/Help:Formatting How to use the wiki code]
*[https://www.mediawiki.org/wiki/Help:Formatting How to use the wiki code]
Line 28: Line 25:
To organize your lesson, and for [https://en.wikipedia.org/wiki/Search_engineoptimization SEO (Search engine optimization)], it is good to add title and different levels of headings.
To organize your lesson, and for [https://en.wikipedia.org/wiki/Search_engineoptimization SEO (Search engine optimization)], it is good to add title and different levels of headings.


Here is an example of page structure (using the Edit Source button)
Here is an example of page structure:


{| class="wikitable"  
{| class="wikitable"  
Line 34: Line 31:
(image)
(image)


'''<code><nowiki><div class="pg_page_title">Vocabulary for animals in English</div></nowiki></code>''' (Lesson title)
'''<code><nowiki><div style="font-size:300%;">Vocabulary for animals in English</div></nowiki></code>''' (Lesson title)


'''<code>==Vocabulary==</code>'''(level 1)
'''<code>==Vocabulary==</code>'''(level 1)
Line 46: Line 43:
'''<code>==Videos== </code>'''(level 1)
'''<code>==Videos== </code>'''(level 1)
|}
|}


Here are examples of existing lessons to inspire you:
Here are examples of existing lessons to inspire you:
Line 54: Line 52:


===Lesson title===
===Lesson title===
Do not use Heading1 for your lesson title because this heading is already used automatically for the page title (the page title is the same as the title in the URL) and we can have only have one Heading1 per page (for SEO reasons).
If you want to write a title for your lesson, USE the following code:
If you want to write a title for your lesson, USE the following code:


'''<code><nowiki><div class="pg_page_title"> TITLE </div></nowiki></code>'''
'''<code><nowiki><div style="font-size:300%;"> TITLE </div></nowiki></code>'''


Do not use:


Important: do not use the heading level 1 code:
'''<code>=TITLE =</code>'''
 
'''<strike><code>=TITLE=</code></strike>'''
This heading is already used automatically for the page title (the page title is the same as the title in the URL) and we can have only have one Heading level 1 per page (for SEO reasons).
This heading is already used automatically for the page title (the page title is the same as the title in the URL) and we can have only have one Heading level 1 per page (for SEO reasons).


===Heading level 2===
===Heading level 2===
Use the following code :
For the first level headings, use the following code :
   
   
'''<code>==Vocabulary==</code>'''
'''<code>==Vocabulary==</code>'''


===Heading level 3===
===Heading level 3===
Use the following code:
For the second level headings, use the following code:


'''<code>===The farm animals===</code>'''
'''<code>===The farm animals===</code>'''


===How to create headings with the visual editor===
==Tables==
 
Here are easy ways to create large tables without having to use the wiki code or the visual editor:
Here is a video on how to create headings and automatically add a table of content:
===Create a table: Solution1===
 
#Create your table in Excel
https://www.youtube.com/watch?v=l2Ebiw4-OrQ
#Use this [http://tools.wmflabs.org/excel2wiki/index.php free tool] to create the wiki code equivalent to your Excel table
#Edit the wiki page with the "Edit source" tab
#Paste the code


==Tables==
===Create a table: Solution2===
Here are easy ways to create tables without having to use the wiki code or the visual editor:
===Create a table: Solution 1===
#Create the table in Excel
#Create the table in Excel
#Copy and Paste the table in the page with the Visual Editor mode.
#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)
#Save the page
#Save the page
#Edit the page, this time, with the "Edit source" tab
#Edit the page, this time, with the "Edit source" tab
Line 95: Line 94:
<code>{| class="wikitable sortable"</code>
<code>{| class="wikitable sortable"</code>
if you want to make it sortable
if you want to make it sortable
===Create a table: Solution 2===
 
#Create your table in Excel
#Use this [http://tools.wmflabs.org/excel2wiki/index.php free tool] to create the wiki code equivalent to your Excel table
#Edit the wiki page with the "Edit source" tab
#Paste the code
===Update a table===
===Update a table===
#Copy the table from the html page
#Copy the table from the html page
Line 105: Line 100:
#Edit your table in Excel
#Edit your table in Excel


Then update the wiki page, using solution 1 or 2 above.
Then update the wiki page, using solution 1 or 2 above
===How to format the table header===
The table header is a special row at the top of the table with the title of each column.


Here is how to create a table header:
Edit the page with the Edit source button:
*replace the following wiki code (only the first line)  :
<code><nowiki>{| class="wikitable"</nowiki></code>
<code><nowiki>|header title 1</nowiki></code>
<code><nowiki>|header title 2</nowiki></code>
<code><nowiki>|-</nowiki></code>
*with this code :
<code><nowiki>{| class="wikitable"</nowiki></code>
<code><nowiki>!header title 1</nowiki></code>
<code><nowiki>!header title 2</nowiki></code>
<code><nowiki>|-</nowiki></code>
You just have, '''ONLY on the first line''', to replace the <code>'''|'''</code> by a <code>'''!'''</code>
===Cool! you can also use HTML code 😉===
If you prefer HTML, you can use it to create tables.
Don't forget to use the class="wikitable" in the table opening tag so the table will look nice.
<code><nowiki><table </nowiki>'''class="wikitable"'''<nowiki>></nowiki></code>
  <code><nowiki><tr></nowiki></code>
    <code><nowiki><td>ligne 1, column 1</td></nowiki></code>
    <code><nowiki><td>ligne 1, column 2</td></nowiki></code>
  <code><nowiki></tr></nowiki></code>
  <code><nowiki><tr></nowiki></code>
    <code><nowiki><td>ligne 2, column 1</td></nowiki></code>
    <code><nowiki><td>ligne 2, column 2</td></nowiki></code>
    <code><nowiki></tr></nowiki></code>
<code><nowiki></table></nowiki></code>


==  Links==
==  Links==
===Internal links===
===Internal links===
To link to a page which URL is <code><nowiki>https://polyglotclub.com/wiki/</nowiki>'''Language/English/Grammar/To-be'''</code> inside the Polyglot club wiki, use the following code:
To link to a page which URL is wiki/Help  inside the Polyglot club wiki, use the following code:
 
<code><nowiki>[[Help|different text]]</nowiki></code>


<code><nowiki>[[Language/English/Grammar/To-be|different text]]</nowiki></code>


===External links===
===External links===
Line 172: Line 116:


*[https://www.mediawiki.org/wiki/Help:Links More information about links]
*[https://www.mediawiki.org/wiki/Help:Links More information about links]


==  Images ==
==  Images ==
*To upload an image, see this link: [http://polyglotclub.com/wiki/Help/Upload-a-Photo-How How to upload and format a photo?]
*[http://polyglotclub.com/wiki/Help/Upload-a-Photo-How How to upload and format a photo?]


Example:
Example:
Line 187: Line 130:
<code><nowiki>[[File:My_pic.png|thumb|My Picture Caption]]</nowiki></code> ''with a caption''
<code><nowiki>[[File:My_pic.png|thumb|My Picture Caption]]</nowiki></code> ''with a caption''


==Voice Recordings (AUDIO, MP3 etc.)==
== Videos ==
See this page:
To add a Youtube video, simply circle the video ID like this:


https://polyglotclub.com/wiki/Help/How-to-add-audio-files
'''<code><nowiki> <youtube>[ID code]</youtube></nowiki></code>'''


== Videos ==
The video ['''ID code'''] can be found inside the URL of a Youtube video.
To add an '''embedded youtube video''' inside a lesson, click the '''EDIT CODE''' button.


Then, simply circle the video URL like this:
Example:
 
'''<code><nowiki> <youtube>[video URL]</youtube></nowiki></code>'''


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


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


if the URL is as follows: '''https://www.youtube.com/watch?v=S4ypgbP2Jn4'''
After inserting the following code:  


use the following code:
'''<code><nowiki> <youtube> S4ypgbP2Jn4 </youtube> </nowiki></code>'''


'''<code><nowiki> <youtube>https://www.youtube.com/watch?v=S4ypgbP2Jn4</youtube> </nowiki></code>'''
the video appears as below:


the video will appears as below:
<hr>
<youtube>S4ypgbP2Jn4</youtube>
<youtube>S4ypgbP2Jn4</youtube>
<hr>


==Lists==
==Lists==
Line 260: Line 198:
[https://www.mediawiki.org/wiki/Help:Lists More information about lists]
[https://www.mediawiki.org/wiki/Help:Lists More information about lists]


==HTML and CSS==
If you know html and css languages, you can do many things like in the following lesson:
* https://polyglotclub.com/wiki/Language/English/Culture/Find-the-Ideal-Penpal
==Create your own page title==
* See this page: https://polyglotclub.com/wiki/Help/Create-your-own-Page-Title
==You have more questions? Check the FAQ==
* Read more answers and ask questions [[Language/Multiple-languages/Culture/How-to-contribute-to-wiki-lessons-(FAQ)|here]].




<hr>
{{Help-menu}}
{{Help-menu}}

Please note that all contributions to Polyglot Club WIKI may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see PolyglotClub-WIKI:Copyrights for details). Do not submit copyrighted work without permission!

Cancel Editing help (opens in new window)

Template used on this page:

Retrieved from "https://polyglotclub.com/wiki/Help/How-to-Write-a-Language-Lesson"