This document is short and does not contain everything to not overwhelm developers. The best thing you can do is get your hands dirty and start cutting and pasting content. This is the general procedure for transferring an existing websites content into the LibreTexts:
Step 1: Build the infrastructure
- Rename the chapter titles to the desired titles (hover over title to get pencil icon to do this and then edit and save): use the format "1: I love LibreTexts" and "2: I really love Libretexts" as the general format with a colon and no "chapter" word
- Rename the existing sections within each chapter to the desired section. Use the format "1.X: Ways that I love Libretexts" and "1.2: Ways that you should love Libretexts" as the general format with a colon after the second number. Avoid using a three number title, e.g., "1.2.3: Ways that Titles Can Be Poor"
- As a general rule, copy everything over even if it is not entirely clear that it will be useful. We can always delete or move things around later.
- If you need to make new sections, then do so (via the "New" button on the black bar after you are logged in)
- If your original sections do not have numbers in them, then ignore the numbers (for now).
- We can address thumbnails (the images on the chapter boxes) later on.
Step 2: Copy and Paste
- For each section of original material, do a simple cut and paste from the website into each LibreTexts section (after clicking "Edit" on black bar after you are logged in)
- When you do this, all text is copied over (often with undesired formatting) and the images from the original content is NOT transferred over (only a link back to them to give you that image). If the formatting is screwy (e.g., small font, bad font etc), then it is best to just erase the formatting (the "removed format" button on the edit toolbar that looks like a T with a little x next to it. That is your best friend.
Step 3: Upload Figures Onto Libretexts Page
- The simplest way to do this is to drag the figures from the original page onto your desktop, the drag them from your desktop into the appropiate spot on the Libretext page. You can find more details on how to do this here.
Step 4: Format the Page
- General Formatting plan:
- erase all indentations
- try to avoid underlines (use bold or italic instead)
- full justify all text
- center justify all image captions
- center justify all images (after copying them in properly, discussed below)
Step 5: Format equations
- if there are equations, then you will need to cover to mathjax (latex). Below are some tutorials to get people started:
- It is best to just look at mathjax code on the LibreText to get the idea. This helps to make nice equations (https://www.codecogs.com/latex/eqneditor.php).
- DO NOT copy links to codecogs to make a latex image on our site; use the internal mathjax system via the \( and \[ (and \) and \]) delimiters.
Step 6: Typesetting and Advanced Editing
- This is more advanced stage that requires review by an advanced developer and includes fine tuning of things, such as table and figure captions, acknowledgements, table formatting, videos, hyperlinks to other pages etc.
- Typically, a pages goes through many revisions to get things "just right"