- \n \t
- How to create internal links<\/li>\n \t
- How to create custom internal links using anchor tags<\/li>\n \t
- How to manage slugs<\/li>\n \t
- Naming conventions<\/li>\n<\/ul>\n<\/div>\n
\u00a0How to Create Internal Links<\/h2>\nInternal links can be used for many different purposes, and at the basic level the process is the same as with regular external links:\n
- \n \t
- In the visual editor, highlight the text you wish to link<\/li>\n \t
- Click on the \u201clink\u201d symbol in the toolbar<\/li>\n \t
- Type in or paste the URL you wish to link to<\/li>\n \t
- Hit enter<\/li>\n<\/ol>\n[caption id=\"attachment_469\" align=\"aligncenter\" width=\"1098\"]
![\"Highlight](\"https:\/\/pb.malartu.org\/pbuserguide\/files\/2013\/04\/nav1.png\")
<\/a>Highlight text and create a link[\/caption]\n\nThe difference when you are linking internally, rather than to a web page as you might be used to, is you don\u2019t have a URL in the traditional sense. Instead, you need to use the identifier (called a slug, more on this below) of an internal location, of which there can be two kinds: default locations and locations that you create yourself. Both of these are used to\u00a0indicate an\u00a0exact point\u00a0in your document.\nDefault Internal Links<\/h3>\n
NOTE:\u00a0<\/strong>Internal links work differently on hosted Pressbooks networks than they do on Pressbooks.com. If you're looking for instructions on creating internal links in\u00a0 Pressbooks.com, go here<\/a>.<\/div>\n \n\nWhen you create a document, there are already some identifiers\u00a0that it will understand. For example, if you want to link to a chapter, you simply need to enter:\n[book-title-here]\/chapter\/[your-chapter-title-here]<\/strong><\/p>\n
To link to a part, enter:<\/p>\n
[book-title-here]\/part\/[your-part-title-here]<\/strong><\/p>\n
To link to a front matter section, enter:<\/p>\n
[book-title-here]\/front-matter\/[your-section-title-here]<\/strong><\/p>\n
To link to a back matter section, enter:<\/p>\n
[book-title-here]\/back-matter\/[your-section-title-here]<\/strong><\/p>\nThe easiest way to find the location identifier of the section-title is to look at the URL of a page in the web version of your book, and copy everything that comes after .com<\/strong> or\u00a0.pub (including the forward slash).\u00a0<\/strong>\n
![\"Copy](\"https:\/\/pb.malartu.org\/pbuserguide\/files\/2013\/04\/eduinternallinks.png\")
<\/a><\/h3>\nCreate Custom Internal Links<\/h3>\nIn order to create links between more than just chapters or parts, you can create custom location tags that you can then link to from anywhere in your book.\n\nLet's say you're writing a\u00a0section of your book, and want to link to a list of terminology that you have written in an earlier chapter, named \"Program Overview\".\n
- \n \t
- Go to the \"Program Overview\" chapter<\/li>\n \t
- Find the \"Terminology\" section heading<\/li>\n \t
- Place your cursor at the start of the heading and click on the \"Anchor\" button on the toolbar (it looks like a small flag, bottom row, fourth in from the left)<\/li>\n \t
- Enter a\u00a0name\u00a0when prompted (this must be unique<\/em>).<\/li>\n \t
- You now have an anchor tag the start of your heading, and should see it appear as a small icon.<\/li>\n<\/ol>\nTo link to it, go back to your chapter in progress, and follow the instructions above to create a link. When it prompts you to enter a URL, enter:\n
[book-title-here]\/chapter\/program-overview\/#terminology<\/strong><\/p>\n
This indicates that the link is to go to a\u00a0chapter<\/strong> named \"Program Overview<\/strong>\" and find the anchor tag called \"terminology<\/strong>\".<\/p>\n\n
Uses:<\/h4>\n
- \n \t
- Link to figures from main body text and vice versa, eg. See Figure 1<\/a>\u00a0(NOTE: to add an anchor tag to an image caption, you must add it manually\u00a0in the image editing window, not the visual editor. Simply enter the caption as <a id=\"[your-id]\"><\/a>[Your Caption]<\/strong>).<\/li>\n \t
- Link to chapter sub-sections.<\/li>\n \t
- Link to specific sections of back matter.<\/li>\n \t
- Link between chapter sections and their related exercises.<\/li>\n<\/ul>\n
Slugs<\/h3>\nThe identifiers we used\u00a0above are commonly (or uncommonly, depending on your perspective) referred to as slugs. These are automatically generated for every section you create, and can be found by looking at your page URL as explained above. However, sometimes you might need to edit them. To do so:\n
- \n \t
- Go into the chapter or section whose slug you want to edit.<\/li>\n \t
- Find the \"Screen Options\" tab in the top right corner of your screen.<\/li>\n \t
- Check the \"Slug\" option.<\/li>\n \t
- Click on \"Screen Options\" again to collapse the tab.<\/li>\n \t
- Scroll down to below the visual\/text editor to find the \"Slug\" section.<\/li>\n \t
- Enter your new slug.<\/li>\n \t
- Save or update your chapter.<\/li>\n<\/ol>\nThis is a handy trick for a few reasons:\n
- \n \t
- If you have a long chapter name, shortening the slug can make it more manageable.<\/li>\n \t
- If you start your title with a number (eg. \"1. Program Overview\"), your exports will add the word 'chapter' or 'part' to the front of the slug, which will break your links to that location. Use the slug editor to make sure your slugs start with a word, not a number.<\/li>\n \t
- If you name both a part and a chapter the same thing, the exports will again add something to distinguish them from each other, breaking the links. Use the slug editor to make sure they're different from each other.<\/li>\n<\/ul>\n
Naming Conventions (and Analog Navigation)<\/h2>\nEven if you aren't planning on using internal links to navigate, it is important to remember a few things about large documents that can be accessed in several different formats.\n\nFor example, if we consider a textbook, one student could be reading the web version, another a copy they printed themselves, and another an ebook version with the font size increased because they have a visual impairment. In this situation, if all three readers are told to go\u00a0to page 138, they will all arrive in very different places. With this in mind, a book that will exist in many formats needs to rely on other kinds of navigation systems.\n\nWe recommend avoiding page references altogether, and instead using a numbering system similar to the following:\n
1. Part Name<\/h1>\n
1.1 Chapter Title<\/h2>\n
1.1.1 Chapter Section<\/h3>\n
1.1.2 Second Chapter Section<\/h3>\n
1.2 Second Chapter Title<\/h2>\n
1.2.1 Chapter Section<\/h3>\nNote: When using this system, be sure to enable the two-level table of contents in \"Appearance --> Theme Options\". This will show both chapter titles and sections on the table of contents in all formats.","rendered":"
\nTextbooks, scholarly monographs and other academic documents are often unique in their large size and their intended use, which is rarely to be read in a linear fashion. Both of these traits mean that readers need clear and easy ways to navigate. This chapter will cover:<\/p>\n
- \n
- How to create internal links<\/li>\n
- How to create custom internal links using anchor tags<\/li>\n
- How to manage slugs<\/li>\n
- Naming conventions<\/li>\n<\/ul>\n<\/div>\n
\u00a0How to Create Internal Links<\/h2>\n
Internal links can be used for many different purposes, and at the basic level the process is the same as with regular external links:<\/p>\n
- \n
- In the visual editor, highlight the text you wish to link<\/li>\n
- Click on the \u201clink\u201d symbol in the toolbar<\/li>\n
- Type in or paste the URL you wish to link to<\/li>\n
- Hit enter<\/li>\n<\/ol>\n<\/p>\n
<\/a>Highlight text and create a link<\/p>\n<\/div>\n
The difference when you are linking internally, rather than to a web page as you might be used to, is you don\u2019t have a URL in the traditional sense. Instead, you need to use the identifier (called a slug, more on this below) of an internal location, of which there can be two kinds: default locations and locations that you create yourself. Both of these are used to\u00a0indicate an\u00a0exact point\u00a0in your document.<\/p>\n
Default Internal Links<\/h3>\n
NOTE:\u00a0<\/strong>Internal links work differently on hosted Pressbooks networks than they do on Pressbooks.com. If you’re looking for instructions on creating internal links in\u00a0 Pressbooks.com, go here<\/a>.<\/div>\n<\/p>\n
When you create a document, there are already some identifiers\u00a0that it will understand. For example, if you want to link to a chapter, you simply need to enter:<\/p>\n
[book-title-here]\/chapter\/[your-chapter-title-here]<\/strong><\/p>\n
To link to a part, enter:<\/p>\n
[book-title-here]\/part\/[your-part-title-here]<\/strong><\/p>\n
To link to a front matter section, enter:<\/p>\n
[book-title-here]\/front-matter\/[your-section-title-here]<\/strong><\/p>\n
To link to a back matter section, enter:<\/p>\n
[book-title-here]\/back-matter\/[your-section-title-here]<\/strong><\/p>\n
The easiest way to find the location identifier of the section-title is to look at the URL of a page in the web version of your book, and copy everything that comes after .com<\/strong> or\u00a0.pub (including the forward slash).\u00a0<\/strong><\/p>\n
<\/a><\/h3>\nCreate Custom Internal Links<\/h3>\n
In order to create links between more than just chapters or parts, you can create custom location tags that you can then link to from anywhere in your book.<\/p>\n
Let’s say you’re writing a\u00a0section of your book, and want to link to a list of terminology that you have written in an earlier chapter, named “Program Overview”.<\/p>\n
- \n
- Go to the “Program Overview” chapter<\/li>\n
- Find the “Terminology” section heading<\/li>\n
- Place your cursor at the start of the heading and click on the “Anchor” button on the toolbar (it looks like a small flag, bottom row, fourth in from the left)<\/li>\n
- Enter a\u00a0name\u00a0when prompted (this must be unique<\/em>).<\/li>\n
- You now have an anchor tag the start of your heading, and should see it appear as a small icon.<\/li>\n<\/ol>\n
To link to it, go back to your chapter in progress, and follow the instructions above to create a link. When it prompts you to enter a URL, enter:<\/p>\n
[book-title-here]\/chapter\/program-overview\/#terminology<\/strong><\/p>\n
This indicates that the link is to go to a\u00a0chapter<\/strong> named “Program Overview<\/strong>” and find the anchor tag called “terminology<\/strong>“.<\/p>\n
Uses:<\/h4>\n
- You now have an anchor tag the start of your heading, and should see it appear as a small icon.<\/li>\n<\/ol>\n
- You now have an anchor tag the start of your heading, and should see it appear as a small icon.<\/li>\n<\/ol>\nTo link to it, go back to your chapter in progress, and follow the instructions above to create a link. When it prompts you to enter a URL, enter:\n