វិគីភីឌា:Training/doc
This is a documentation subpage for វិគីភីឌា:Training. It may contain usage information, categories and other content that is not part of the original វិគីភីឌា page. |
These trainings are built with a page structure and templates that make it relatively easy to use the same content in multiple trainings, add new content, and rearrange existing content.
The basic elements of a training topic are:
- The index (e.g., វិគីភីឌា:Training/For students/Editing index): a list of pages that make up a topic, such as the "Editing" topic within វិគីភីឌា:Training/For students. The title of the index should be a subpage at the same level as the individual content pages, and takes the form "វិគីភីឌា:Training/<something>/<topic> index". The contents of the index are used by Module:TrainingPages to determine how many pages are in the topic, what the page number of a given page is, and what the previous and next pages are. Thus, pages can be added, removed, or reordered within a topic simply by changing the index.
- The header / footer templates on each page (e.g, វិគីភីឌា:Training/For students/Citing sources): each training page uses {{វិគីភីឌា:Training/header}} at the beginning and {{វិគីភីឌា:Training/footer}} at the end. The basic parameters are topic (used in both header and footer, indicates which index to use), title (used in header, shows up above the main content), and pagestyle (used in header, determines how wide the main content is, main options are 400-width, 600-width, 800-width). By default, the color scheme is determined using the name of the topic, via {{វិគីភីឌា:Training/colors}}; the default color for a new topic can be added by editing that. Alternatively, the color parameter can be used with any valid CSS color.
- Page content (e.g, វិគីភីឌា:Training/core/Citing sources): the content of each page can either be added directly between the header and footer, or transcluded (e.g., from a វិគីភីឌា:Training/core page). Depending on the pagestyle set by the header, this will get squeezed into the training page format with a maximum width of 800px or less.
How to create a new training
[កែប្រែ]- Make an outline of what the training will cover.
- Pick a name, and create a menu such as វិគីភីឌា:Training/Example. (Use the inputbox below to use {{វិគីភីឌា:Training/menu}} as a starting point.) The training pages will be subpages of this.
- Based on your outline, create an index listing the page titles for all the pages that will be part of the training as a subpage of the menu. The index subpage should take the form /<topic> index, such as វិគីភីឌា:Training/Example/Welcome index. The pages listed should also be subpages of the menu, with descriptive subpage names. (If your training will be broken up into several topics, create a separate index for each topic.)
- Create the first page listed on the index, such as វិគីភីឌា:Training/Example/Welcome, using the header and footer templates. It should look something like this:
{{វិគីភីឌា:Training/header | topic = Welcome | title = Welcome to the Example training }}
This is the content of the first page.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
{{វិគីភីឌា:Training/footer | topic = Welcome }}
- If everything is in order, that first page should draw from the index to automatically link to the next page. Create each page until you've done all the pages in the index.
- You can reorganize the training by editing the index (and creating any additional pages as needed).
- To connect one topic to another, you can use the next and previous parameters in the footer to specify the appropriate page to link to.
- Specify the color for each topic by adding the topic and CSS color code to វិគីភីឌា:Training/colors.
Additional features
[កែប្រែ]- optional template parameters
- next / previous - In the {{វិគីភីឌា:Training/footer}} template, the next and previous parameters ( "
next = វិគីភីឌា:Training/Example/foo
" ) specify the page linked respectively with the forward and back arrows. If these parameters are absent, the footer template will the topic index to calculate the next and previous page. Using them with no value ("next =
") will make the respective arrow disappear. - page - In {{វិគីភីឌា:Training/header}}, using the page parameter ( "
page = 7(b)
" ) will replace the page number calculated by the index. It can be used for pages that aren't part of the index but are still within the topic. - link - In {{វិគីភីឌា:Training/header}}, using the link parameter ( "
link = [[វិគីភីឌា:Foo|Foo]]
") will insert the link specified into the top right of the training page. For example, see វិគីភីឌា:Training/For educators/Improve research skills 2. - quote / source - In {{វិគីភីឌា:Training/header}}, using the quote and source parameters ( "
quote = I love Wikipedia. | source = Jimmy Wales
") will present the quote with nice formatting, using the topic color for the quotation marks. For example, វិគីភីឌា:Training/For students/valuable contribution. - week - In {{វិគីភីឌា:Training/header}}, using the week parameter ( "
week = 2
" ) will insert {{វិគីភីឌា:Training/syllabus links}} into the footer. This is probably only useful if you are porting over the example 12-week syllabus as part of the training. For example, see វិគីភីឌា:Training/For educators/Week 2.
- other features
- Resources - If a training has a subpage called Resources, such as វិគីភីឌា:Training/For students/Resources, then a link to it will appear next to the "Menu" link on each page of the training.
- feedback pages - It may be useful to invite users to give feedback at the end of training. For one example of how to do this, see:
- វិគីភីឌា:Training/For students/Training complete - final page of training, with button to leave feedback
- Other pages used: វិគីភីឌា:Training/core/Training complete students, វិគីភីឌា:Training/For students/Training feedback/editintro, វិគីភីឌា:Training/For students/Training feedback/preload
- វិគីភីឌា:Training/For students/Training feedback - feedback page where students leave comments
How to port trainings to another wiki
[កែប្រែ]To port trainings to another wiki, start by transferring over all the templates used in the trainings, as well as a Lua module. (An administrator on the other wiki can import them using Special:Import.)
- main templates
- additional templates that may be useful
- វិគីភីឌា:Training/menu
- វិគីភីឌា:Training/doc
- វិគីភីឌា:Training/Blue highlight
- វិគីភីឌា:Training/Green highlight
- វិគីភីឌា:Training/syllabus links
- វិគីភីឌា:Training/syllabus table
- Template:Clickable button
- Template:Clickable button 2
- additional general templates used in individual training pages, as needed
Once you have the main templates transferred over (and translated, if necessary), you can either transfer the training content en masse from Category:Wikipedia training and the content pages, which start with "វិគីភីឌា:Training/core/", or you can start building a training from scratch (beginning with the steps above) and port individual pages as needed. Contact User:Sage Ross (WMF) for assistance.