Differences

This shows you the differences between two versions of the page.

--- plugin:strata [2023-04-21 20:01] – Aleksandr
+++ plugin:strata [2025-11-16 14:24] (current) – 2a01:e0a:e6a:52f0:ac8d:2b3e:eab0:83a6
@@ Line 3: / Line 3: @@
 ---- plugin ----
 description: Add and query semi-structured data in your wiki
-author     : Brend Wanders
+author     : François Kaag
-email      : brend+strata@13w.nl
+email      : francois.kaag@cardynal.fr
 type       : syntax, action, helper
-lastupdate : 2021-12-17
+lastupdate : 2025-11-16
-compatible : 2020-07-29 "Hogfather"
+compatible : Jack Jackrum, Kaos, Librarian
 depends    :
 conflicts  : caption
 similar    : data, fields, struct
-tags       : !discontinued, database, sqlite, data, tables, listing, mysql, postgresql
+tags       : database, sqlite, data, tables, listing, mysql, postgresql
-downloadurl: https://github.com/bwanders/dokuwiki-strata/zipball/master
+downloadurl: https://github.com/fkaag71/dokuwiki-strata/zipball/master
-bugtracker : https://github.com/bwanders/dokuwiki-strata/issues
+bugtracker : https://github.com/fkaag71/dokuwiki-strata/issues
-sourcerepo : https://github.com/bwanders/dokuwiki-strata/
+sourcerepo : https://github.com/fkaag71/dokuwiki-strata/
 donationurl:
@@ Line 21: / Line 21: @@
 ----
-:!: **This plugin is no longer maintained. You might want to check the [[struct|struct plugin]], or one of the other similar plugins noted above.**
+This plugin was originally created by [[[email protected]|Brend Wanders]]. Although he could not maintain it any longer after 2021, it is still useful, since no other data plugin seems to propose graph based queries that fit extremely well with the Wiki structure.
 The Strata plugin allows you to add data to your pages, just like the [[data]] plugin. You can think of this data either as named values attached to the page, or as describing things on the page in a more structured way.
@@ Line 36: / Line 36: @@
 Search and install the plugin using the [[extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
-After installation, it might be useful to copy the contents [[https://github.com/bwanders/dokuwiki-strata/blob/master/manual.txt|manual.txt]] on Github to a wiki page on your installation. This will put the [[~:reference guide]] on your own wiki installation, complete with listing of available types and aggregates.
+After installation, it might be useful to copy the contents [[https://github.com/fkaag71/dokuwiki-strata/blob/main/manual.txt|manual.txt]] on Github to a wiki page on your installation. This will put the [[~:reference guide]] on your own wiki installation, complete with listing of available types and aggregates.
 Strata followes DokuWiki's [[config:useheading]] configuration when displaying links. Changing that setting will also adjust how Strata displays links, which might help with making a lot of the automatically generated listings and links look better.
@@ Line 220: / Line 220: @@
   * **link** (type hint: The link title)\\ Creates a link. This type is multi-purpose: it handles external links, interwiki links, email addresses, windows shares and normal wiki links (basically any link DokuWiki knows of). The optional hint will be used as link title.
   * **ref** (type hint: namespace)\\ References another piece of data or wiki page, and creates a link. An optional hint can be given to change how links are interepreted when saving them: if present, the hint is used as namespace for the link. If the hint ends with a #, all values will be treated as fragments.
+  * **title** is identical to **ref**, except that the page heading will be used instead of the page name to display the link.
   * **wiki**\\ Allows the use of dokuwiki syntax; only non-block syntax is allowed (only links, formatting, etc.; no tables, headers, and other large stuff). The hint is ignored.
+  * ** enum** (type hint: value set name)\\ Searches the entry in the value set, a ''<data>'' block where rows are in the form ''label: entry'', and displays the label corresponding to the entry, or #NA if no correspondence was found.
@@ Line 243: / Line 245: @@
   * **Default database source name** (//Default:// ''sqlite:@METADIR@/strata.sqlite''): The [[phpfn>PDO]] data source name used to connect to the database. The ''@METADIR@'' token will be replaced with the path of DokuWiki's meta data directory.
   * **The name of the 'is a' relation** (//Default:// ''is a''): The predicate that should be used to indicate the 'is a' relation. This is used when you enter a data block with one or more classes.
+  * ** Data scope reduced to the current namespace ** (//Default:// ''inactive''): When set, only the triples within the current namespace are considered in expressions.
   * **The name of the 'entry title' relation** (//Default:// ''entry title''): The predicate that should be used to indicate the 'entry title' relation. The 'entry title' relation links a human readable label to the data entry. Normally, this is done automatically by the data block syntax, this setting only changes the relation used to attach the title to the data.
   * **Enable debug information?** (//Default:// no): Tick this box if you want to have more extensive information on what's going wrong. For example, use it when the connection to the database fails.
@@ Line 324: / Line 327: @@
 === Change Log ===
+After adoption:
+{{rss>https://github.com/fkaag71/dokuwiki-strata/commits.atom date}}
+Before adoption:
 {{rss>https://github.com/bwanders/dokuwiki-strata/commits/master.atom date}}
@@ Line 331: / Line 336: @@
   * The [[plugin:sqlite]] plugin gives warnings that the ''strata.sqlite'' files needs to be renamed?
     * The [[https://github.com/bwanders/dokuwiki-strata/issues/9|SQLite problems (#9)]] issue describes the symptoms and offers two solutions.
+===== Tutorials =====
+Here you can find tutorials on Strata as YouTube videos or DokuWiki pages with many examples:
+  * [[https://youtu.be/Tu_0PcIeHsY?si=fwL3ZBajk4geLwPj|YouTube: Strata]] (German)
+    * [[https://t.me/DokuWikiRu/1845|In Russian (Auto-translation; Telegram)]]
+  * [[https://ww-a.de/strata/|Strata-Tutorial]] as a German-language DokuWiki page
 ===== Bugs, Feature Requests and Patches =====
-Please submit bugs and feature requests in the [[https://github.com/bwanders/dokuwiki-strata/issues|issue tracker on github]]. The easiest way to submit patches is through forking on github and opening a pull request. Alternatively, patches can be sent in unified diff format or as git patches against the master branch.
+Please submit bugs and feature requests in the [[https://github.com/fkaag71/dokuwiki-strata/issues|issue tracker on github]]. The easiest way to submit patches is through forking on github and opening a pull request. Alternatively, patches can be sent in unified diff format or as git patches against the master branch.