aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/forum/debconf13_ikiwiki_bof.mdwn97
-rw-r--r--doc/plugins/write/names.mdwn25
-rw-r--r--doc/users/chrysn/interests.mdwn6
3 files changed, 127 insertions, 1 deletions
diff --git a/doc/forum/debconf13_ikiwiki_bof.mdwn b/doc/forum/debconf13_ikiwiki_bof.mdwn
new file mode 100644
index 000000000..4da99f5f7
--- /dev/null
+++ b/doc/forum/debconf13_ikiwiki_bof.mdwn
@@ -0,0 +1,97 @@
+There has been a meeting of people interested in ikiwiki
+[[during debconf13|http://penta.debconf.org/dc13_schedule/events/1060.en.html]]
+on 2013-08-11.
+
+Summary
+=======
+
+Ikiwiki's state and development
+-------------------------------
+
+Ikiwiki has reached a stable state with a working ecosystem, with the majority
+of changes being minor adaptions and bugfixes these days.
+
+It is unlikely that there will be a major overhaul any time soon.
+
+If incompatible changes are to be made, that might warrant a 4.$DATE
+transition, especially given that the [[ikiwiki-transition]] mechanism has not
+been used for some time. Potential changes for such a transition will be
+discussed (see below).
+
+Names of pages and links
+------------------------
+
+Several of [[the issues chrysn deals with|users/chrysn]] revolve about the
+differences betwen a page's name, its title, the name of source and destination
+page, how they are converted, and which is used when.
+
+chrysn has starting to draft a page on [[plugins/write/names]], and
+would appreciate review and comments.
+
+Themability
+-----------
+
+The default theme of ikiwiki is more appealing to the people who are expected
+to run an ikiwiki setup; end users with Web 2.$current_minor_version
+expectations often don't have there tastes served well.
+
+[[Recently|version 3.20130518]], templates have become more theming friendly,
+but for the general case still require the theme to be known to mainline
+ikiwiki, lest generic templates diverge. A planned feature is generalized
+sidebars, where more places inside the template can be filled using the same
+mechanism as currently used in the [[pluginssidebar]] pluin, but changes there
+require a complete rebuild. (Not worse than the rebuilds required when changing
+the main templates, but it would be more tempting to frequently change them.)
+
+Examples of fancy ikiwiki themes have been brought up:
+
+ * https://www.gresille.org/
+ * https://nos-oignons.net/
+ * http://www.rezine.org/accueil/association/
+ * https://cas-libres.poivron.org/
+
+A generalized version of the [[bootstrap|http://twitter.github.com/bootstrap/]]
+[[theme|theme market]] would be appreciated, as the current one is targeted
+towards a particular installation.
+
+Performance
+-----------
+
+Rebuilding many pages takes considerable time, especially when sidebars are
+changed.
+
+A faster way to use the page index (eg. sqlite) would help speeding up the
+usual rebuilds, but would not help speeding up massive rebuilds.
+
+RDF backend
+-----------
+
+On the priority level "crazy ideas", it was discussed to augment or finally
+change the index to an RDF triple collection. Statements would be extracted
+from the source pages in the scan hook, and form a triple store. Pagespecs
+would be resolved to SPARQL queries against that database; also the
+[[todo/structured page data]] fields could be addressed with this.
+
+Optimizations are still possible, even more generally, for example with
+dependencies on other pages' title:
+
+* page A sets its own title with `\[[!meta title="the A page"]]`, which results
+ in the statement '`<./page_A> dc:title "the A page" .`'.
+
+* page B uses some kind of auto-titling link to page A: `\[[~|page A]]`, which
+ queries for '`<./page_A> dc:title ?a`'.
+
+* When page B is built, it is stored that it depends on statements involving
+ the term `<./page_A>`, and the current hash value of all statements about
+ that term. (Those will be computed for all observed statements at scan time.
+ Pages that use more complex queries might not be able to list all their
+ dependencies.)
+
+ Also, the queries and query results executing during building page B are
+ stored in a separate cache.
+
+* When some other page starts linking to page A, the first cache is
+ invalidated, as now there are more statements on the subject of
+ '`<./page_A>`', so page B might need to be rebuilt. Before that is done, its
+ cached queries are executed. If their results did not change, page B does not
+ need any further action.
diff --git a/doc/plugins/write/names.mdwn b/doc/plugins/write/names.mdwn
new file mode 100644
index 000000000..88bc2d93c
--- /dev/null
+++ b/doc/plugins/write/names.mdwn
@@ -0,0 +1,25 @@
+*This page is work in progress and can not be considered to be part of the
+documentation so far.*
+
+This page describes the various forms the name of a page can take.
+
+[[!table data="""
+concept | example
+-----------------|-----------------------------------------------------------------------------
+title | '`dir A/page B`' unless a meta title is defined
+link | '`dir_A/page_B`' or '`dir A/page B`' or '`page_B`' / '`page B`' when inside dirA
+page name | '`dir_A/page_B`'
+source file | '`/dir_A/page_B/index.mdwn`' or '`/dir_A/page_B.mdwn`' depending on indexpages
+rendered file | '`/dir_A/page_B/`' or '`/dir_A/page_B.html`' depending on usedirs
+"""]]
+
+
+functions:
+
+* `pagename`: source file to page name
+* `pagetitle`: page name to title but not considering meta title
+* `titlepage`: title to page name but not considering meta title
+* `linkpage`: link to page name
+* `htmllink`: page name to html link to rendered file
+* `bestlink`: link to page name
+* `htmlpage`: page name to rendered file
diff --git a/doc/users/chrysn/interests.mdwn b/doc/users/chrysn/interests.mdwn
index c506481e4..592ef58e1 100644
--- a/doc/users/chrysn/interests.mdwn
+++ b/doc/users/chrysn/interests.mdwn
@@ -7,9 +7,11 @@ these are the topics [[chrysn]] is or was interested in inside ikiwiki:
* [[bugs/Underscores in links don't appear]]
* [[bugs/unicode encoded urls and recentchanges]]
* [[bugs/wrong link in recentchanges when reverting an ikiwiki outside git root]]
-* [[forum/managing todo lists]]
+* [[forum/debconf13 ikiwiki bof]]
* [[forum/link to an image inside the wiki without inlining it]]
+* [[forum/managing todo lists]]
* [[ikiwiki/directive/map/discussion]]
+* [[plugins/write/names]]
* [[todo/ad-hoc plugins]]
* [[todo/alias directive]]
* [[todo/auto-create tag pages according to a template]]
@@ -20,8 +22,10 @@ these are the topics [[chrysn]] is or was interested in inside ikiwiki:
* [[todo/inline postform autotitles]]
* [[todo/internal definition list support]]
* [[todo/mirrorlist with per-mirror usedirs settings]]
+* [[todo/more customisable titlepage function]]
* [[todo/natural sorting]]
* [[todo/sort parameter for map plugin and directive]]
* [[todo/tracking bugs with dependencies]]
+* [[todo/unaccent url instead of encoding]]
* [[todo/Using page titles in internal links]]
* [[todo/wikitrails]]