Jump to content

វិគីភីឌា:Training/doc

ពីវិគីភីឌា

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

[កែប្រែ]
  1. Make an outline of what the training will cover.
  2. 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.

  3. 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.)
  4. 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 }}
  5. 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.
  6. You can reorganize the training by editing the index (and creating any additional pages as needed).
  7. 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.
  8. Specify the color for each topic by adding the topic and CSS color code to វិគីភីឌា:Training/colors.

Additional features

[កែប្រែ]
optional template parameters
other features

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

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.