How do I make my own module?
- Browse to the page that you want to edit
- Click “edit page” directly under the tool bar at the top
- Start writing!
- When you are done click “save”. This will save your page and bring you out of editing mode. To continue editing click “edit page” again.
- Note that there is no auto save function, so save your work frequently.
How do I use the editor?
The LibreTexts is built with a FCK editor that allows for module construction without having to build/edit the raw source (HTML) code directly. It has been configured for most of the needs contributors require. The layout is below; please refrain from using the advanced features in red until you are familiar with the Dekiwiki structure.
Can I use my own editor and cut & past the results?
In principle yes. You are encouraged to compose your module in a text-only word processor (e.g., Notepad), or process your content through a text-only processor (via cutting and pasting). Then review your text for errors, then cut and paste the final version into the appropriate text box on the module. Some formatting characters used in programs like Word (angled quotes, accents, special characters) will not display properly. Save your edits, review your final text, and make any edits necessary to correct the format.
How do I format the module?
Each module is unique in its optimal approach. The below guidelines will help in construction.
- Use the formatting tools on the top of the page (editing mode only)
- Super and sub scripts (see buttons on edit bar)
- Start by writing an introduction that puts your topic in a greater picture
- Add hyperlinks to other LibreText modules
- Save intermediate versions of your module.
- Use proper formatting (e.g. Zn2+ instead of Zn2+)
- Check spelling and grammar
- Include examples from the “real world”
- Make figures. A picture says more than a thousand words!
- Comment on other people modules. Critical comments will be considered for your extra credit.
- Be creative!
- Copy text or pictures from anywhere unless confirmed public domain! Note: Many wikipedia images are not in the public domain! DO NOT use GNU general public licensed material.
- Personalize the formatting of your module excessive use of colors, font sizes, etc or by changing the font type.
- Insert hyperlinks every time you use a particular word (use common sense to decide if it is useful)
- Write exclusively in the form of bulleted lists. You are writing a text book, not lecture notes.
How do I add pictures?
Three steps to add non-copyrighted (e.g. public domain, creative commons, own photos, or figures made from scratch) images or pictures:
- "Save" or "export" the figures into jpg, png, gif or some other graphics file depending on the program you are using to make the image.
- Then "attach" the file using the lower right hand button on the page or under the "more" button.
- Then "edit" the page with the edit button and "link" the file to your page with "insert/edit image" button (looks like a mountain with a sun).
Additional factors to pay attention to regarding figures:
- NO BMP figures. They do not print well with the wiki. Use PNG, JPG, GIF figures instead.
- Please CROP your figures to remove superflous white space that makes reading your module awkward. The Microsoft Office Picture Editor will crop images and is free on MS operating systems.
- ALL figures constructed for this project must have the original non-image files used uploaded to the chemwiki, preferable in the module itself.
Places to get free figures (you MUST CONFIRM THIS WITH A URL FROM WHERE YOU TOOK THE FIGURE):
How do I add equations?
The alternative (and preferred) approach MathJax instead. MathJax and the system we use on the LibreTexts are very similar. Details about it: http://www.mathjax.org/. This link http://www.codecogs.com/latex/eqneditor.php is an online WYSIWYG LaTeX editor that creates math expressions using templates. The LaTeX is automatically written and a preview is displayed. Just copy the code and paste it. Be sure to enclose the LaTeX in dollar signs ($).
Examples to learn from:
How do I add hyperlinks?
- Mark the word you want to be the hyperlink, then click the hyperlink button (L) with the "chain link" icon
- If you want to link to an outside page place the address in the “link to” box and click “update link”
- If you want to link to an internal ChemWiki module you can use the “browse” option to find the page. You can also use the search function to look for key words (make sure you check that the page is a relevant link though).