In this chapter we'll show you how to add:\na) External links to web pages\nb) Internal links within the book<\/div>\n

External Links<\/h2>\nYou can add a link to any external website using the VISUAL EDITOR, or the TEXT editor.\n

Visual Editor<\/h3>\nHere is how you add a link in the visual editor:\n
\n \t
Write some text<\/li>\n \t
Highlight the text<\/a><\/li>\n \t
Click on the \"Link\" icon in the toolbar<\/li>\n \t
Add your link<\/li>\n<\/ul>\nSee:\n\n[caption id=\"attachment_937\" align=\"alignnone\" width=\"976\"] $\"Adding$ <\/a> Adding an external link[\/caption]\n
TEXT Editor<\/h3>\nUsing the TEXT editor, the format should be:\n
This <a href=\"http:\/\/somesite.com\">text has a link<\/a>\u00a0and then goes on.<\/code><\/div>\nInternal Links (Links Within Your Book)<\/h2>\nYou can also link within your book, for instance from one chapter to another. 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) 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. Here's how you do it:\n Default Internal Links<\/h3>\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\/chapter\/[your-chapter-title-here]<\/strong><\/p>\nTo link to a part, enter:\n \/part\/[your-part-title-here]<\/strong><\/p>\nTo link to a front matter section, enter:\n \/front-matter\/[your-section-title-here]<\/strong><\/p>\nTo link to a back matter section, enter:\n \/back-matter\/[your-section-title-here]<\/strong><\/p>\nThe easiest way to find this location identifier is to look at the URL of a page in the web version of your book, if the chapter has been published, and copy everything that comes after .com<\/strong>\u00a0(including the forward slash).\u00a0<\/strong>\n<\/h3>\nIf the chapter is still in draft, just look at the permalink below the chapter title and\u00a0copy everything that comes after .com<\/strong>\u00a0(including the forward slash).\u00a0<\/strong>\n\n<\/a>\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\u2019s say you\u2019re writing a\u00a0section of your book, and want to link to a list of terminology that you have written in an earlier chapter, named \u201cProgram Overview\u201d.\n\n \tGo to the \u201cProgram Overview\u201d chapter<\/li>\n \t Find the \u201cTerminology\u201d section heading<\/li>\n \t Place your cursor at the start of the heading and click on the \u201cAnchor\u201d 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 \tYou 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\n\/chapter\/program-overview\/#terminology<\/strong>\n\nThis indicates that the link is to go to a\u00a0chapter<\/strong> named \u201cProgram Overview<\/strong>\u201d and find the anchor tag called \u201cterminology<\/strong>\u201c.\nUses:<\/h4>\n\n \tLink 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=\u201d[your-id]\u201d><\/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<\/h2>\n<\/code><\/h3>","rendered":"In this chapter we’ll show you how to add: \na) External links to web pages \nb) Internal links within the book<\/div>\nExternal Links<\/h2>\nYou can add a link to any external website using the VISUAL EDITOR, or the TEXT editor.<\/p>\nVisual Editor<\/h3>\nHere is how you add a link in the visual editor:<\/p>\n\nWrite some text<\/li>\nHighlight the text<\/a><\/li>\n Click on the “Link” icon in the toolbar<\/li>\n Add your link<\/li>\n<\/ul>\nSee:<\/p>\n<\/a><\/p>\nAdding an external link<\/p>\n<\/div>\nTEXT Editor<\/h3>\nUsing the TEXT editor, the format should be:<\/p>\nThis <a href=\"http:\/\/somesite.com\">text has a link<\/a>\u00a0and then goes on.<\/code><\/div>\nInternal Links (Links Within Your Book)<\/h2>\nYou can also link within your book, for instance from one chapter to another. 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) 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. Here’s how you do it:<\/p>\n Default Internal Links<\/h3>\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:<\/p>\n \/chapter\/[your-chapter-title-here]<\/strong><\/p>\n To link to a part, enter:<\/p>\n \/part\/[your-part-title-here]<\/strong><\/p>\n To link to a front matter section, enter:<\/p>\n \/front-matter\/[your-section-title-here]<\/strong><\/p>\n To link to a back matter section, enter:<\/p>\n \/back-matter\/[your-section-title-here]<\/strong><\/p>\n The easiest way to find this location identifier is to look at the URL of a page in the web version of your book, if the chapter has been published, and copy everything that comes after .com<\/strong>\u00a0(including the forward slash).\u00a0<\/strong><\/p>\n<\/h3>\nIf the chapter is still in draft, just look at the permalink below the chapter title and\u00a0copy everything that comes after .com<\/strong>\u00a0(including the forward slash).\u00a0<\/strong><\/p>\n<\/a><\/div>\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.<\/p>\n Let\u2019s say you\u2019re writing a\u00a0section of your book, and want to link to a list of terminology that you have written in an earlier chapter, named \u201cProgram Overview\u201d.<\/p>\n\nGo to the \u201cProgram Overview\u201d chapter<\/li>\n Find the \u201cTerminology\u201d section heading<\/li>\n Place your cursor at the start of the heading and click on the \u201cAnchor\u201d 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>\nYou 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:<\/p>\n \/chapter\/program-overview\/#terminology<\/strong><\/p>\n This indicates that the link is to go to a\u00a0chapter<\/strong> named \u201cProgram Overview<\/strong>\u201d and find the anchor tag called \u201cterminology<\/strong>\u201c.<\/p>\nUses:<\/h4>\n\nLink 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=\u201d[your-id]\u201d><\/a>[Your Caption]<\/strong>).<\/li>\n Link to chapter sub-sections.<\/li>\n Link to specific sections of back matter.<\/li>\n Link between chapter sections and their related exercises.<\/li>\n<\/ul>\n<\/h2>\n <\/code><\/h3>\n","protected":false},"author":1,"menu_order":2,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":"cc-by"},"chapter-type":[],"contributor":[],"license":[50],"part":198,"_links":{"self":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/206"}],"collection":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/206\/revisions"}],"predecessor-version":[{"id":207,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/206\/revisions\/207"}],"part":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/parts\/198"}],"metadata":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/206\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/media?parent=206"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapter-type?post=206"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/contributor?post=206"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/license?post=206"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}