18.1 – Add External Links

18.1.1 – Visual editor

This is how you can add external links in the visual editor:

1. Write some text
2. Highlight the text
3. Click on the “Link”-icon in the toolbar
4. Enter your link

18.1.2 – Text editor

In the text editor you can add a link as follows:

The yellow part is where the reader will click on, the blue part creates the hyperlink.

18.2 – Add Internal Links (within the book)

18.2.1 – Internal links to chapters, parts or section

If you want to add a link to a part within your book you can use so called “slugs”. Slugs are identifiers of internal locations. They are basically everything that comes after the “eskript.ethz.ch” (including the forward slash).

Any slug can be built like this:

• for chapters: /chapter/[name_of_chapter]
• for parts: /part/[name_of_part]
• for sections: /front-matter/[section_title] or /back-matter/[section_title]

If the chapter is still a draft, you can find the slug in the permalink below the chapter title.

18.2.2 – Custom links to any tags in the text

You can create links to any parts in your text, you just have to tag them. Here are the steps to follow:

1. Place your cursor to the part of the text, where you want to link to
2. Add an anchor (icon that looks like a flag in the toolbar)
3. Give a name to the anchor (must be unique)
4. A small icon appears where you placed the anchor
5. Go back to where you want to add the link
6. Follow the instructions for internal links and add “/#anchorname

 

18.3 – Referring to a Subchapter, Image or Table

In the chapter “How to subchapter and number subchapters” we talked about the two icons that pop up, when you click on a heading.

Here is the explanation for the second icon: When clicking on the “less than” “greater than” icon, a reference ID appears and can be copied onto the clipboard. This reference ID serves as a link to the subchapter and can be inserted into the text whenever needed.

Reference IDs cannot only be obtained for subchapters, but also for images and tables. The respective reference IDs can always be obtained by clicking on the “less than” “greater than” icon.

18.4 – Referencing Formulas

You can also let your formulas be numbered by adding and ‘id’ in the latex shortcode. To reference, use the ‘ref id’ shortcode and use the id of the formula!

 

18.5 – Citations and References

This subchapter handles the input of citations and references in eSkript.
For informations about the citation etiquette at ETH, have a look here.

There are short citations and full citations. The short citations are the ones in brackets placed directly behind the cited text. The full citations are placed at the end of the chapter in the subchapter “References/Bibliography”. The full citations are mandatory, the short citations are helpful but you can also just insert the full citation as footnote (Section 18.6) to the cited text. If you need the short and full citations to link back and forth, you need to do it in the TEXT Editor.

Steps:

1. Write the citations as you would in a textfile
2. Add the following code around your short citation
   < a id=”short-citationID” href=”#full-citationID”> short citation </a>
3. Add the following code around your full citation
   < a id=”full-citationID” href=”#short-citationID”> full citation </a>
4. Put the ID of the short citation into the link (href) of the full citation and vice versa
   Note: the IDs can be any word, but they have to be unique, like the anchor names we saw before!

 

 

18.6 – Footnotes

To add footnotes put the cursor where you want a footnote, click on the FN symbol in the toolbar and enter the footnote text or put the text for the footnote between the brackets^[1].

 

 

 

 

---