How to write a topic

Building a new topic is easy!

Before adding a new topic be sure that an analogous topic does not exists inside the Department

If it does, you can improve and complete the already existing one by editing content and/or creating new chapters. Feel free to write different versions of already existing chapters: it will be the reader to choose which one he prefers.

  1. Surf until the page of the department in which you want to write the topic
  2. click on the button "edit"" of the selected department. For example, if you want to write a Physics topic, click edit on Physics
  3. Add in the right section of the page the link to the topic you'd like to create with the syntax [[Name of the topic]] and save the page.
  4. It'll appear a red link with the name chosen. This means that a link to a non-existing page has been created.
  5. Click on the red link, click edit and go on with chapters insertion as described below. Save the page and your topic has been created!

A topic has to follow these conventions:

  • Introduction to the topic: insert a brief description of the topic you're going to write. Use the Template Description
  • Put chapters inside sections. For this purpose use the Template Section
  • Insert in the template field section textthe dotted list of chapters:

{{Section |sectionTitle=section title |sectionText=*[[/Chapter 1/]] *[[/Chapter 2/]] }} The chapter has to be made as a subpage of the topic: this is the meaning of syntax [[/Chapter/]]. Slash means creation of a subpage of the current page.

  • Chapter is thought to be independent of the others so that it can be used in different books. This is the reason why we ask you to make explicit references to "previous" and "following" chapters only between chapters of the same section. Connections between chapters belonging to different sections have to be made through explicit links(ex: in chapter [[name of the chapter]] ...)
  • Each chapter can have a set of subchapters, but not sub-subchapters:[[/Chapter/Subchapter/]]. Subchapters have to be inserted in the section with a ** before the link, which makes a further indentation.
  • If you don't want the link to show the whole path of the page you can use the following syntax:[[/Chapter/Subchapter|Name you want to be seen]]
  • To insert bibliography in your topic use the TemplateBibliography. Bibliography items can be inserted though the Template Reference
  • Inside each chapter paragraphs have to be titled with con ==Paragraph title==

In order to give a uniform look to the site we ask you to follow these conventions :

  • Chapters can be opened with a title-less paragraph and further paragraph subdivisions are not strictly required
  • Every title opening a paragraph must be written inside two double equal signs (==Title==)
  • Do not use bold or italic inside titles
  • Use a predefined formatting model when possible: look for a suitable one here: Template List
  • Chapters belonging to the same section can be referred to explicitly, e.g. "in the previous chapter we have seen...", while other chapters need to be referenced using links, e.g. "as already described in [[Chapter Name]], ..."
  • Avoid external references: if absolutely necessary, insert them as footnotes [1]

Summary of syntax[edit | edit source]

Syntax for a section

{{Section
|sectionTitle="Title"
|sectionText=
*[[/Chapter/]]
**[[/Chapter/Subchapter/]]
}} 
{{Bibliography}}
{{Reference|author=name|title=name of the title|editor=name of the editor|edition=name/number of the edition|par=paragraph}}you can insert just some of these field

Syntax for a chapter

* [[/Name of the chapter/]]

Syntax for a subchapter

** [[/Name of the chapter/Name of the subchapter]]

Syntax to change visualized link:

[[/Name of the chapter/Name of the subchapter|Name you want to be visualized]]
The best way of learning how to write topics is looking at the already existing ones!Go on Physics_of_Atoms_and_Molecules, click edit and read the syntax
  1. external link