💾 Archived View for jb55.com › ward.asia.wiki.org › internal-link-style-guide captured on 2022-01-08 at 14:04:57. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2021-12-04)
-=-=-=-=-=-=-
Double-square-brackets makes a word or phrase into a hyperlink. This works best if the link is surrounded by words or placed in a context that makes it clear to a reader when thy might benefit from a shift of context.
See also Link Word for external citatons.
If the link is one of a set of choices let it stand alone.
Some lists deserve links with clarifying subtitles.
Digression Workflow accommodates attention deficit
If the link adds relevant material offer direction.
See Digression Workflow
Use stronger direction to emphasise importance.
See also Digression Workflow
Add clarification to qualify the direction.
See Digression Workflow when you find pages ramble.
If the link expands one paragraph then elaborate within.
Writers can capture thoughts outside their current focus by spawning new pages and leaving appropriate citations behind. See Digression Workflow
There are link forms we discourage or recommend only be used in specialized circumstances.
Link words embedded in text. This disrupts the flow of the text creating a mental burden on the reader. It also suggests that the link is an accident rather than a sincere recommendation of the author. Especially avoid linking words or phrases for emphasis with no intention for them to name pages in a site.
Duplicated links. When talking about a page one can link the first reference but not any other. Use title case for all references since the title is a proper noun. However, words used to express an idea independent of a page should not be linked or capitalized.
Free Association. Resist the temptation to recommend to the reader content that they might also like because the pages are a favorite of yours and just came to you.
Mechanical Lists. One can configure the Activity plugin to behave like a table of contents. This really only works for sites that are databases without any particular structure.