Testwiki:Manual of Style සඳහා මුලාශ්‍රය නරඹන්න

{{ඉංග්‍රීසි විකිපොත් වෙතින් ආයාත කළ පිටුව}}
{{draft|WB:MOS}}

The '''Wikibooks Manual of Style''' serves to establish good structural and stylistic practices to help editors produce higher quality wikibooks. 

== Wikibook titles ==
: ''See also [[Wikibooks:Naming policy]] for information on how to name books and their chapters.''

Wikibooks should be titled based on their ''aspect''. This is a combination of the target audience, scope, and depth of the book. Several books on one topic but with differing aspects can exist. For example, a book on woodwork aimed at the general public may be entitled simply "Woodworking", and a mathematics text for commerce students may be called "Mathematics for Commerce" or "Commercial Mathematics" instead of simply "Mathematics".

Some people prefer to use [[wikt:title case|title casing]], as books often do, while other people prefer to use [[wikt:sentence case|sentence casing]], as Wikipedia does. Title casing is recommended for [[Wikibooks:Naming policy|''book titles'']] as it reduces potential confusion between title- and shelf-[[Wikibooks:Categories|categories]]. Casing on ''[[Help:Editing#Subpage links|subpage]] names'' and ''[[Help:Editing#Sections|sections]]'' is entirely a matter of style. Whatever combination of schemes for book titles, pages and sections, please be consistent and follow the existing style for books you are editing.

Sub-page names that describe what the chapter is about &mdash; for example, "<tt>[[Chess/Notating_The_Game]]</tt>" &mdash; are preferred over numbered chapters &mdash; like "<tt>Chess/Chapter_10</tt>" &mdash; so that inserting new chapters in between existing chapters, or reordering chapters, requires less work.

== Structure ==
: ''See also [[w:book design|book design]] for some helpful tips and ideas.''

=== Main page ===
The main page is generally the first page a new reader sees.  It should give a quick overview of the scope, intended audience and layout of the book.  [[w:Glossary of comics terminology#Splash|Splash pages]] should be avoided.  Often the layout is simply the full table of contents.  Collections, printable versions and PDF files should be easily accessible from this page.

Links to the book from the [[Wikibooks:Card Catalog Office|card catalog office]] and external websites should point to a book's main page. The subject index on the card catalog office requires the {{tl|shelves}} template to be placed on the main page of the book. The book's main page and category should be placed in any [[Wikibooks:Categories|categories]] that the book belongs to. Indicate a book's completion status with {{tl|status}} to provide readers with an idea of how far along the book is when browsing the [[Wikibooks Stacks/Departments|shelf pages]]. If you still require help with categorizing a book, please [[WB:HELP|request assistance in the reading room]].

Interlingual links should be placed on the book's main page. Books across language projects may be dissimilar even when about the same subject. Be wary about placing interlingual links on any other pages.

=== Table of contents ===
In general, the table of contents should be on the main page, giving readers an overview of the available material. In cases where this is impractical, a special page can be created for it. Common names for such pages are <tt>''Contents''</tt>, <tt>''Table of contents''</tt> or similar.

<gallery widths="64px" heights="64px" caption="Table of contents examples">
File:Wikibooks standard toc.svg|Standard TOC
File:Wikibooks 2col toc.svg|2 column TOC
File:Wikibooks 2col toc2.svg|2 column TOC
</gallery>

=== Introduction ===
An [[w:Introduction (essay)|introduction]] page is the first page where learning begins. A book's introduction page commonly delves into purpose and goals of the book; what the book aims to teach, who the audience is, what the book's scope is, what topics the book covers, history of the subject, reasons to learn the subject, any conventions used in the book, or any other information that might make sense in an introductory chapter. Common names for such pages are <tt>''Introduction''</tt> or <tt>''About''</tt>. The latter is more commonly used when information about the book is split from the introduction of the subject matter.

The [[Help:Local manuals of style|local manual of style]]—when it is not part of the <tt>''Introduction''</tt> page -- is often named literally "Local style manual", "Manual of style", "How to contribute", "How you can help", "About", etc. &mdash; appended to the book name, of course.
Whatever it is called in the book you are editing, it would be nice if a link to it is on the same page as the table of contents.
Having a local manual of style is further discussed in [[WB:LMOS]].

=== Navigation ===
{{see also|Wikibooks:Templates/Navigation}}

Navigation aids are links included on pages to make navigating between pages easier. Navigation aids can help make reading books easier for readers, but can also make maintaining and contributing to books harder. Most web browsers can back track through pages already visited, and the wiki software also adds links for navigating back to the table of contents if pages use the slash convention in their name and a book's main page is the table of contents as suggested. Using a book-specific template to hold navigation aids (rather than copy-and-paste onto each page of the book) can help reduce some of the maintenance issues, since only that template must be edited if things change. There is no standard for navigation aids. Navigation aids are optional due to their potential drawbacks.

=== Bibliography ===
A [[wikt:bibliography|bibliography]] is useful for collecting resources that were cited in the book, for linking to other useful resources on the subject that go beyond the scope of the book, and for including works that can aid in verifying the factual accuracy of what is written in the book.  When used, such pages are commonly named <tt>''Further Reading''</tt>, <tt>''References''</tt>, or similar.

=== Glossary ===
A [[w:glossary|glossary]] lists terms in a particular domain of knowledge with the definitions for those terms. A glossary is completely optional and is most useful in books aimed at people new to a field of study. <tt>''Glossary''</tt> should always be used for such a page.

=== Appendices ===
An [[wikt:appendix|appendix]] includes important information that does not quite fit into the flow of a book.  For example a list of math formulas might be used as an appendix in a math book.  Appendices are optional and books may have more than one appendix.  Examples of common ways to name appendices are <tt>'''Appendix/Keywords'''</tt> and <tt>'''Appendix:Formulas'''</tt>.

Examples:

* [[Conlang/Appendix/Glossary]]
* [[Inkscape/Appendix:Reference]]

=== Cover pages ===
Cover pages are useful for print versions. These should be separated from the main page (remember: Wikibooks is not paper) but can be used to make print versions.
When used, commonly named <tt>''Cover''</tt>.

=== Print versions ===
See [[Help:Print versions]] for more on print versions.  They are often named <tt>''Book Name/Print version''</tt>.

=== PDF versions ===
Some books have a <tt>''File:Bookname.pdf''</tt> for the entire book at once in a single PDF file.
If someone creates a PDF version of a book, it would be nice if that PDF file were mentioned at [[Wikibooks:PDF versions]], and {{tlx|PDF version}} were placed on the table of contents to link to that PDF file.

=== Examples ===
* [[Control Systems]] has a great introduction describing (and linking to some of) the prerequisites for this book.
* [[Spanish]] uses a splash page, but the table of contents is well annotated and accessible.
* [[Haskell]] has a very nice layout sectioned off for audiences of different levels.

== Style ==
Where appropriate the first use a word or phrase akin to the title of the page should be marked in '''bold''' and when a new term is introduced, it is ''italicised''.

=== Headers ===
{{see also|Help:Editing#Sections}}
Headers should be used to divide page sections and provide content layout.  Primary information should be marked with a <nowiki>"=="</nowiki>, and information secondary to that should be marked with a <nowiki>"==="</nowiki> header, and so on, for example:

 == Animals ==
 There are many kinds of animals.
 
 === Cats ===
 Cats are animals.
 
 === Dogs ===
 Dogs are animals.

There is no need to provide systematic navigation between headers; only provide navigation between pages. A list of sections is automatically provided on the page when more than 3 headers are used.

=== Linking ===
{{see also|Help:Editing#Links}}

Books with a deep sub-page hierarchy should include navigation links to help navigate within the hierarchy. [[Help:Templates|Templates]] can help maintain consistency by making it easy to include navigational aids on the necessary pages.

=== Footnotes and references ===
{{see also|Help:Editing#References}}

Wikibooks has a couple of really simple implementations for footnotes and references. One uses {{tl|note}} to place notes at the bottom of the page and {{tl|ref}} to reference these at appropriate places in the text. The other places the references between <nowiki><ref> and </ref></nowiki> tags right in the text, and then uses the {{tl|reflist}} or <nowiki><references /></nowiki> to automatically generate a list of these at the bottom of the page.

=== Mathematics ===
{{see also|Help:Formulas}}
Format using HTML or in-line Mediawiki markup when using variables or other simple mathematical notation within a sentence. Use <nowiki><math></math></nowiki> tags for more complicated forms.

Use italics for variables: ''a''+''b'', etc. Do not use italics for Greek letter variables, function names, or their parentheses.

To introduce mathematics notation in a ''display'' format, move to the start of the new line, add a single colon, and then the notation within the <nowiki><math></math></nowiki> tags. If punctuation follows the notation, do so ''inside'' the tags.

For example:
{| class="wikitable" width="100%"
! width="50%" | Markup !! Display
|-
|<source lang="tex" inline>
: <math>\int_0^\infty {1 \over {x^2 + 1}}\,dx = \frac{\pi}{2}</math>
</source>
|
: <math>\int_0^\infty {1 \over {x^2 + 1}}\,dx = \frac{\pi}{2}</math>
|}
is correctly used for "display" guidelines.

If a notation does not render as a PNG, you may force it to do so by adding a "<tt>\,\!</tt>" at the end of the formula.

=== Software ===
Books that are about computer software or rely on the use of computer software to illustrate examples should clearly indicate which version of the software is relevant to the book, page, or section at hand. Templates to help with this and examples of their usage is available at [[Wikibooks:Templates/General#Software Versions|Wikibooks:Templates]].


{{Wikibooks policies and guidelines}}

<!-- Categories-->
[[Category:Manual of Style]]