💾 Archived View for jb55.com › ward.asia.wiki.org › link-word captured on 2021-12-05 at 23:47:19. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2021-12-04)

-=-=-=-=-=-=-

Link Word

Wiki has a distinct markup for links that go to pages outside the wiki. Here we suggest a style for using that markup that suites both writer and reader.

Any external link should be part of a paragraph that explains why one might be interested in the external content.

Any external link caries with it the loss of context as a new tab brings with it new formats, look and feel.

The link-word convention suggests that all external links be composed of a single word, lower case, trailing a paragraph, punctuated only with the automatic off-site link icon.

One should choose a word that gives a clear indication of page type, but not page content. The content has already been addressed by the preceding paragraph.

<h3> Example

Elephants are large mammals of the family Elephantidae and the order Proboscidea. Traditionally, two species are recognised, the African elephant (Loxodonta africana) and the Asian elephant (Elephas maximus). wikipedia

wikipedia

<h3> Format Words

These words indicate the type of content one would expect to find. They are suggested when the content represents a viewing commitment distinctly different from native web browsing.

<b>pdf</b> — pdf formatted as pages

<b>mp3</b> — audio ready to play or download

<b>video</b> — video ready to be played

<b>post</b> — a blog permalink

<b>doc</b> — a shared google doc page or similar

ebook — a full book displayed in a custom online reader.

<h3> Site Words

These words refer to resources available on public sites familiar within a community.

<b>wikipedia</b> — articles, people, searches

<b>github</b> — repos, files, issues

<b>youtube</b> — movies, channels

<b>nyt</b> — news

<b>blog</b> — a blog's front page

<b>amazon</b> — books, stuff

soundcloud — community annotated sound files

wayback — a snapshot from the Wayback Machine

slideshare — presentation viewer

<h3> Web Words

These words describe web pages when no more specific word applies.

<b>site</b> — a website home page

<b>page</b> — a specific page within a website

<h3> Access Words

These words warn users that they should not expect their simple browsing behavior to continue through these links.

<b>download</b> — expect a download to start

<b>pay</b> — expect a paywall login

<h3> Purpose Words

These words describe a reason to link that might have more to do with where they appear than where they go.

<b>source</b> — used when a caption describes data.