Difference between revisions of "Photonics Wiki Stylesheet"
Cmditradmin (talk | contribs) |
Cmditradmin (talk | contribs) m (→References) |
||
| Line 21: | Line 21: | ||
== References == | == References == | ||
Article references should be mentioned where they are relevant in the text with "See Taylor" followed by the full article citation in ref tags. | Article references should be mentioned where they are relevant in the text with "See Taylor" followed by the full article citation in ref tags. Include a DOI identifier when possible. | ||
== Graphics == | == Graphics == | ||
Revision as of 07:36, 11 August 2010
The Photonics Wiki is meant to be more of textbook / tutorial presentation than a standard wiki. We hope that students will be able read a section from the main menu and follow a coherent presentation from page to page. The sections reflect the original recorded lectures that were transcribed and appended. Some styles we will use throughout.
Each page within a section should have a Return to main menu button that takes you back to the main page outline at that section point in the outline. It should also have a "next topic" and "last topic" button to take you to the next page in that section. This is done with a short table at the top of the page. Longer scrolling pages should have the same table at the bottom of the page
<table id="toc" style="width: 100%"> <tr> <td style="text-align: left; width: 33%">[[Introduction to Absorption|Previous Topic]]</td> <td style="text-align: center; width: 33%">[[Main_Page#Absorption and Emission of Light|Return to Absorption and Emission Menu]]</td> <td style="text-align: right; width: 33%">[[Jablonksi Diagram| Next Topic]]</td> </tr> </table>
Headings
Every full article should have 3 plus headings so that the table of contents section is automatically generated. Take care to make the headings instructive and parallel. Ideally the TOC provides a coherent outline of content to be covered and its conceptual organization.
Math Equations
Full size equations should be done in Latex. Variables should be defined below using latex for the variable (or term) itself and followed by a definition of the term in plain text.
References
Article references should be mentioned where they are relevant in the text with "See Taylor" followed by the full article citation in ref tags. Include a DOI identifier when possible.
Graphics
Most graphics are positioned to the right using the thumb tag and 300 or 400px depending on the legibility of the info and space needs for surrounding text. Captions should restate the title or provide fuller explanation as derived from the main text. Progressive reveal builds from powerpoint should be output as a set with acrobat and embedded as a document. If slide notes are available for these they should be included at the time of pdf creation.
External links
Additional website links should be included at the end. Be conservative because these will add to our maintanence headaches.