Index your WorkThis page gives an overview of indexing WikiBooks. That is, making entries on the relevant subject pages and other category lists, so that books can be found. The content of this page is basic, though further details can be found by following the links in theSee Also section at the end of the page. All books are assigned to somesubject area.. To do this, asubject entry is made on the cover page of each book, bearing the name of the subject category. In addition to thissubject listing, a book can be assigned to other categories. These other categories are different in that they arecross-subject categories; that is, theycould have, but need not have, books in them from more than one subject. There are many existingcross-subject categories for this project's books, including;
|
A page's assigned category can be found in its bottom line.As was implied in the section above , categories exist in hierarchies. The links on category pages lead tosub-categories, or eventually to the book pages themselves, so clearly, it is possible to get toany category by simply following the trail of links. However, a quicker way to access a known category is to search for it on theSearch for Categories page. Follow the link toSearch for Categories, then narrow the search by entering the starting letter and the category type.
Alternatively, to access any category listing just type the details into thesearch box on the left of any WikiBooks page. Notice that with the exception of the first character, a category's name is case sensitive; so,Category:Box Templates is not the same page asCategory:Box templates.
The top level subjects can also be found on the WikiBooksMain Page. These top level subjects break down into sub-categories of subject, though users are limited in their assigned subjects to the ones that already exist. New subjects cannot be made by users, though newgeneral categories can. Recent advice implies that subject categories can be user-modified but attempts to do so have met with difficulty; unless users can determine the methods to employ they would be best to assume that the subject hierarchy is fixed.
As a simple example of accessing theWikiBooks category, enter the wordcategory and the categoryname separated by a colon, as follows:
The page will open. Click any of the links to go to the various sub-categories, and so-on for the links within these.
WikiBooks is organised on abook basis. Thecover-page of each book is itsmain page, sometimes called thebook page, and this page will often have user-made links in it to go to the other pages of the book. Because the making of user-links to sub-pages is of variable quality, it is apparent that there is a need for abook category, with a complete set of links to all of the pages of a book.
To build abook category, each sub-page of the book and themain page itself must have a category-tag linking it to that listing; that is, all of these tags must be thesame. It is usual for thebook category to have the same name as the book itself, to keep things logical. As a result, the sub-pages are always accessed by way of the user links on themain page or the automatically made links on thebook category page. Thebook page on the other hand bears any additional tags to connect it into the indexing hierarchy. In summary, readers can use the subject listings to access themain page, that is, thebook page of the book, and if necessary there is a category page called thebook category where links to the pages in the book could also be found.
For example,Editing Wikitext is the name of the book containingthis page and thebook category has the same name. Themain page has navigation hyperlinks made by the author, (not to be confused with category links), for fast access to the other pages. All of the pages have a link to thebook category page. These links were made with thecategory-tag. For these particular sub-pages the code for the links is hidden away in templates, but you can see the usual result at the bottom of each page. Clicking any of these links leads to thebook category, where, for convenience, all such pages are listed.Notice that both themain page and thebook category have further links to subject pages higher in the system, but that sub-pages do not link directly to any subject page.
 | Note that category tags of any kind are most often typed at the end of each page, partly to avoid disrupting the page's formatting and partly so that they can be found easily. In fact, the links can be placedanywhere on a page, and can also be added as text in a template. When such a template is called into use, it is as if thecategory-tag were typed into the editing window. An example of such a template is used as the top section panel forEditing Wikibooks, where an additional back-link to themain page has also been added. |
| Technical Note: |
Once the main page'ssubject has been assigned, and thebook category built, the basic task is complete. Then, in addition to these minimum requirements, any of the book's pages can be assigned togeneral categories that are of further help to users; for example, an administrator might use ageneral category to remind of work that is required on certain books or on individual pages. There are few restrictions on the making ofgeneral categories, and these are assigned by adding an additionalcategory tag to the page.Note that the subject assigned must be one that already exists; this differs fromgeneral categories where any required category is easily made.
Sometimes, despite there being manygeneral categories, a new one is needed. This can happen when a user discovers some purpose that must not get mixed up with other existing entries. Note that it makes little difference whether a category is madebefore making a reference to it, or not. This section explains the details.
Assume that you have decided on the category name and its position within the category hierarchy; that is, you know the intended new category name and the name of the category that it in turn should belong to. Assume for this description that the intention is to make ageneral category calledSandwiches within the categoryFast Food. To make sure that theSandwiches category does not already exist, and as a constructive starting point, it is best tosearch for the intended name. Follow the method outlined in the above section,Find Categories, to make the search.
If the pagealready exists, it will be listed in the search results and you will need to think again about your choices. If itdoes not exist, then the search listing will include the offer tocreate this page. Select the link and it leads to a new editing page, already named and ready to type.
Because all of the entries are automatic, there is onlyone thing that needs be typed in the editing window and it is the category's own category link. Type this anywhere in the editing window, (note the underscore), and then save the page.
If you forget to make the reference to the higher category, or forget to save the page, then any links to the new page will not work and will appear in red. This is easily fixed by correcting the omission.
At the bottom of the saved page will be seen the category link that you have just typed. You are now ready to add pages to your new category.
As was explained in sections above, the book is assigned to an existing subject area, and the subject is restricted to those found by following links from the top level subjects. This section shows the code line to type to assign a book page to asubject and any page to a general category.
Having determined that there is an existing subject calledHelp and that it is appropriate, thehome page ofEditing Wikitext can be assigned to theHelp subject by typing the following at the end of the editing window:
To assignthis page to thebook category ofEditing Wikitext in its most basic form, type the following:
| If the page being assigned is a template page, be sure that acategory-tag is used and that the category link is madewithin the <noinclude></noinclude> tags, to avoid its being considered a part of the template's function. |
| Technical Note: |
Make separate category entries, one for each. The system will combine them for you after the save.
The default listing within a category page is alphabetical, using the first letter of thehome page. In addition, thewhole local address that follows thehome page is displayed in a category list. This has consequences for a page that lies several directories lower in a file tree, since the whole file tree will be listed in the category list, and the sort key will suit thehome page, not the sub-page. The full address text that is listed in this way cannot be changed, and this limits the usefulness of the entire process.
There is one exception to the listing rule, and that is in removing a namespace prefix, for example, from a template name. The following code could be used to categorise theTemplate:Caption page underText Templates while listing only the wordCaption, under 'C' instead of the 'T' that would otherwise result.
The {{PAGENAME}} magic word is able to strip a namespace prefix from the page name. Elsewhere, it may be necessary to make a link to a category page within text; the way to do it without forcing an unwanted categorisation is to prefix the category tag with a full colon.
Note that work that is entirely confined to onlyone page, such as templates and other utility pieces do not have sub-directories or sub-pages; they do not suffer from this excessive listing problem. In these cases the simple notation will suffice. For these cases, the method of using a changed sort position is mentioned here for completeness. At the most general level, by adding acharacter after the name of the category, separated with a pipe symbol, the listing position is changed to it, but the full address is not shortened. In fact, when aword is used instead of the singlecharacter, like in the template example, its first character of the word is used for positioning.
For example, to categorise a page calledAbbreviations in Latin as belonging to theAbbreviations category under 'L' instead of the default sort order under 'A', type this:
As far as is known, only one entry can be specified in this way. That is to say, a title cannot be listed under two different sections in the category.
This method makes most sense for single pages at the top-directory level since sub-pages would defeat the object with a long directory listing. The method clearly is of limited use in its present form, and a system that permitsany text to be depicted in a category list is but the stuff of dreams.