browser

Philosophy

philosophy
calendarsave
=== 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: dot-single an unique identifier dot-single a human-readable title dot-single body text dot-single 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: dot-single all references are wrapped in square brackets dot-single all reference have an identifier and an optional title (separated by a space from the identifier) dot-single Identifiers to lists of traits are the IDs of traits prepended by a hash dot-single identifiers to internal items are the IDs of other items prepended by a forward slash dot-single 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