Philosophy
philosophy=== Rationale
Thoughts is a personal wiki.
Although it can be deployed on the web and supports a simple, key-based authentication system potentially allowing multiple users, it is meant to be used first and foremost as a single-user tool.
The aim of Thoughts is to manage personal knowledge. Knowledge comes in many shapes and forms but it can typically be represented as text, or in media which can have a textual representation or be identified via text - a URL pointing to a web site or an image, for example.
=== Core Concepts
== Items
The main (and only) unit used to manage knowledge is an item. Every item in Thoughts is comprised by:
an unique identifier
a human-readable title
body text
a list of metadata information, represented via TRAITS
While the body text of an item is typically text, depending on the format it can be set to something which can be converted into a non-textual representation, like a hyperlink, an image, a video, or a map. It is however important to note that Thoughts does not foresee storage of non-textual information, but it can process certain formats into appropriate media (use a URL to display an image, for example).
== Traits
= Kind
= Format
= Access
= Attribute
= Custom
== Markup
= Icons
= Font Ligatures
= References
Each item can contain references to other items or to external resources outside of the wiki. Such references are not modeled in Thoughts' data model but they are included in the item text using special lightweight markup.
In general:
all references are wrapped in square brackets
all reference have an identifier and an optional title (separated by a space from the identifier)
Identifiers to lists of traits are the IDs of traits prepended by a hash
identifiers to internal items are the IDs of other items prepended by a forward slash
identifiers to external items are simply the URIs to such resources, typically URLs or other identifier prefixed by a protocol or pseudo-protocol (like tel:).
= Functions