HPCE/gitea-pages
0
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Activity

content updates

Browse Source
This commit is contained in:
Tom Johnson
2015-08-12 18:45:08 -07:00
parent 2a81d2a101
commit e19638e498
48 changed files with 187 additions and 181 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
doc_hyperlinks.md
View File

@ -2,11 +2,13 @@
title: Links
audience: writer, designer
tags: [formatting, navigation]
summary:
keywords: links, hyperlinks, cross references, related links, relationship tables
summary: "When creating links, although you can use standard HTML or Markdown, a better way to handle links is to store them as captured variables in an include file, and then reference the capture keywords for the links. This way you can update titles in one place, more easily identify broken links, and better manage your links. This approach is simliar to the keyref-style links in DITA."
last_updated: August 12, 2015
---
{% include linkrefs.html %}
## Link strategy
## Link strategies
One of the more difficult parts of a documentation site is keeping all the internal links accurate and valid. Although there are many ways to create links, I'll just describe what I've found to work well.