I sat down tonight to write something about PurpleNumbers, as I have several things I need to write for the 0.2 release of PurpleWiki. This is what came out. It fills a different, but similar, purpose to the coolness draft. (000103)
A purple number is an identifier unique to a document or set of documents used to indicate and provide direct access to segments of content in a document. (000105)
In practice a purple number identifies structural elements in a document such as headers, list items and paragraphs. When a new document is created or content is added to an existing document, the document is parsed to add identifiers where they are not already present. When a document is processed for presentation (usually, but not always, to HTML) these identifiers are used to create anchors and links in the document that can be used for later reference. (000106)
Purple number identifiers are known, for reasons of history, as node identifiers, or 'NIDs' for short. (000107)
In simple implementations NIDs are unique per document and may be generated per page, perhaps as a series of integers. More complex implementations create NIDs that are unique across a domain of documents. These NIDs are generated from a central sequencing source or service that provides the next available NID. If NIDs are paired with document identifiers (usually URLs) to create an index, references may be made by NID alone (some uses for this are described below). (000108)
When a document that has been processed to add NIDs is presented as HTML, the NIDs are shown as links (<a href>) to named anchors (<a name>) within a stable URL for the current document. In some current implementations these links are shown in a purple color (thus the name). (000109)
If the identifiers used are human readable (short, sensible), there are benefits to displaying the identifier as the text of the link: reference can be made to the identified segment of content in speech. When the identifiers are more complex a single character, such as the '#' popularized as a permanent link in some weblogs, has proven to work well. (00010A)
Current purple number implementations process text, wiki formatted text, or HTML to either specially formatted wiki text or HTML. The resulting wiki text or HTML embeds text containing the NIDs for each segment of the document. When HTML or wiki text that contains NIDs is reprocessed that text which has already been assigned a NID keeps it's existing NID and that text which is new gets the next NIDs provided by the sequencing service. If content is deleted, NIDs must not be reused as references to NIDs must be allowed to go stale when content is removed. (00010B)
HTML presentations of content with purple numbers adjusts the content in two ways to provide two different functions: the href provides the text of the URL that can be copied to make reference from other environments; the named anchor provides the location to which that reference points. The value of the name attribute of the anchor is the NID. (00010C)
When NIDs for a set of documents are created from the same central source and the NIDs are paired with the URLs of the document in which they are to be presented the resulting index can be used to remotely make reference to content by NID alone. This has several benefits: (00010D)
There are several existing implementations of purple numbers. Some examples are: (00010H)
See also: PurpleNumbers, PurpleWiki, PurplePlugin, TransClusion and the rest of the geek-glaxon category. (00010Q)
Sun | Mon | Tue | Wed | Thu | Fri | Sat |
---|---|---|---|---|---|---|
1 | 2 | 3 | 4 | |||
5 | 6 | 7 | 8 | 9 | 10 | 11 |
12 | 13 | 14 | 15 | 16 | 17 | 18 |
19 | 20 | 21 | 22 | 23 | 24 | 25 |
26 | 27 | 28 | 29 | 30 |
RSS:
(:techanarti) R
(:techanarti) Co R
...pickhits... R
A. R
All Climbing R
All Climbing Com R
amy young-leith R
Bells and Whistl R
Bill de hÓra R
Blog R
BookBlog R
Burning Behind t R
cdent's Photos R
climbingfilms.co R
Comics: Calvin a R
Comics: Doonesbu R
Comments on your R
Common Craft R
crankypants repo R
Designed to give R
EEK Speaks R
Excess bandwidth R
Fire Will Rain D R
Frank Ovitz R
Get Fuzzy R
GeWiki R
Glacial Erratics R
Greg's Climbing R
GrowingPains R
How to Save the R
Idle Words R
Joe R
Kevin R
KwikiSOAP Wiki R
Life With a Knif R
MacMinute R
Mapping reality R
Matt R
mike.whybark.com R
MrCozy R
Peter Kaminski R
Photos from cden R
poupou R
PubSub: burningc R
Purple R
PurpleBlog R
PurpleWiki R
Ranchero R
Recent YSDN Wiki R
RedHanded R
Ross Mayfield's R
sdghsdywaijsrd5t R
Shady Goings On R
Simon Willison's R
Smoking for Purp R
Socialtext R
spacetoday.net R
Surfin' Safari R
Tessier R
the iCite net de R
The Official Kwi R
The Watering Hol R
This space for r R
this verdant fie R
tins ::: Rick Kl R
To Philly, From R
Urbanape : R
ursulas_mom R
Usable Security R
Vacuum R
Wasta R
We're Rhode Isla R
ziptie R