UbuntuHelp:WikiSandBox/CategoryConcept

文章出处:

https://help.ubuntu.com/community/WikiSandBox/CategoryConcept

点击翻译:

English

请不要直接编辑翻译本页，本页将定期与来源同步。

Example concept for new Wiki categories

In July 2009, a thread on the ubuntu-doc mailing list discussed putting documents into categories. This section of the site demonstrates a way of implementing categories suggested by Andrew Sayers and Marc Kaplan.

To-Do

1. Create list of Categories and SubCategories. Assigned to: marckaplan
2. Remove outdated project articles. Assigned to: Rocket2DMn
3. Develop a template for new pages, and requirements to create them (ie- approval from mailing list?)
4. Develop a SubCategories template page
5. Create new"NewPage" tool to work with Categories/SubCategories
6. Determine if Categories can be required prior to saving edits, perhaps via drop-down box
7. Create demo and Subcategory pages as examples
8. Modify Specs page accordingly.

Categories

By default, categories are labeled ` ie:

 <<Category>>/<<PageName>>

However, when the page name is entered as a URL in the address bar, the MoinMoin Wiki software translates this as:

 http://wiki.ubuntu.com/CategoryPageName

As you can imagine, this can potentially lead to extremely long URLs.

Proposal

Each category must have at least the following sub-pages:

This page (which can be blank) defines a header that should be present in every page in the category.

 [[/Categories/CategoryInfo:About|Categories]]

This page includes a very simple category hierarchy and editorial information about what goes in this category, etc. Example: https://help.ubuntu.com/community/WikiSandBox/

Each topic would be a top-level wiki page. This allows ordinary editors to decide where a topic goes, and to change their minds about where a topic goes, without waiting for admins. The basic format for a category page is:

<<Include(Category/Major/CategoryInfo:header)>>

 (PAGE CONTENT GOES HERE)

----
<<Include(Category/Major)>>

Users would then be able to access the ist of pages contained directly within this category by going to:

  * [[/Categories/Applications/CategoryInfo:About|Categories/Applications]]

Any sub-categories of this category would work in a similar fashion, ie: [[UbuntuHelp:WikiSandBox/]]

<<Include(Category/Major/Minor/CategoryInfo:header)>>

 (PAGE CONTENT GOES HERE)

----
<<Include(Category/Major/Minor)>>

Users would then be able to access the ist of pages contained directly within this category by going to:

  * [[/Categories/Applications/CategoryInfo:About|Categories/Applications/Accessories]]

[[category:CategoryInfo:<<blank>>]]

Other page names beginning with `.../ are reserved for future use, and "real" category names must not contain a `:` character.

Page Formatting Sidenote

Each of these categories use `<<FullSearchCached>>` to maintain lists of relevant pages and sub-categories, so it's necessary perform the `Delete Cache` action when a new sub-category or page within the category is created. The use of ` after a horizontal rule near the end of the page tells !MoinMoin that this is a member of the " category. Among other things, this is supported in the Search page (if anyone still uses that). There are also two generic content pages:

• [[UbuntuHelp:WikiSandBox/]]
• [[UbuntuHelp:WikiSandBox/]]

These demonstrate how a page would be added to a category. They've been modified slightly from the description above, in order to work within this concept section.

Creating new categories

In order to reduce the burden on page-readers and writers, creating a new category involves quite a lot of little jobs. To reduce the workload on category creators, a new [[UbuntuHelp:WikiSandBox/ template page|&action=show]] would talk the editor through the process. This template aims to talk the category creator through all the steps they need to take, without limiting the number of extra steps they might choose to take, if they want to style their category any further.