git.oblomov.eu Git - ikiwiki/blob - doc/users/tschwinge.mdwn

   1 [[!meta title="Thomas Schwinge"]]
   2 # Thomas Schwinge
   3
   4 <tschwinge@gnu.org>
   5 <http://www.thomas.schwinge.homeip.net/>
   6
   7 I have converted the [GNU Hurd](http://www.gnu.org/software/hurd/)'s previous
   8 web pages and previous wiki pages to a *[[ikiwiki]]* system; and all that while
   9 preserving the previous content's history, which was stored in a CVS repository
  10 for the HTML web pages and a TWiki RCS repository for the wiki; see
  11 <http://www.gnu.org/software/hurd/colophon.html>.
  12
  13 # Issues to Work On
  14
  15 ## Stability of Separate Builds
  16
  17 The goal is that separate builds of the same source files should yield the
  18 exactly same HTML code (of course, except for changes due to differences in
  19 Markdown rendering, for example).
  20
  21   * Timestamps -- [[forum/ikiwiki__39__s_notion_of_time]], [[forum/How_does_ikiwiki_remember_times__63__]]
  22
  23     Git set's the current *mtime* when checking out files.  The result is that
  24     <http://www.gnu.org/software/hurd/contact_us.html> and
  25     <http://www.bddebian.com:8888/~hurd-web/contact_us/> show different *Last
  26     edited* timestamps.
  27
  28     This can either be solved by adding a facility to Git to set the
  29     checked-out files' *mtime* according to the *AuthorDate* / *CommitDate*
  30     (which one...), or doing that retroactively with the
  31     <http://www.gnu.org/software/hurd/set_mtimes> script before building, or
  32     with a ikiwiki-internal solution.
  33
  34   * HTML character entities
  35
  36     <http://www.gnu.org/software/hurd/purify_html>
  37
  38 ## Tags -- [[bugs/tagged__40____41___matching_wikilinks]]
  39
  40 Tags should be a separate concept from wikilinks.
  41
  42 ### \[[!map]] behavior
  43
  44 The \[[!map]] on, for example,
  45 <http://www.gnu.org/software/hurd/tag/open_issue_hurd.html>, should not show
  46 the complete hierarchy of pages, but instead just the pages that actually *do*
  47 contain the \[[!tag open_issue_hurd]].
  48
  49 ## Anchors -- [[ikiwiki/wikilink/discussion]]
  50
  51 ## Default Content for Meta Values -- [[plugins/contrib/default_content_for___42__copyright__42___and___42__license__42__]]
  52
  53 This will decrease to be relevant, as we're going to add copyright and
  54 licensing headers to every single file.
  55
  56 ## Texinfo -- [[plugins/contrib/texinfo]]
  57
  58 Not very important.
  59
  60 ## Shortcuts -- [[plugins/shortcut/discussion]]
  61
  62 ## \[[!meta redir]] -- [[todo/__42__forward__42__ing_functionality_for_the_meta_plugin]]
  63
  64 Implement a checker that makes sure that no pages that use \[[!meta redir]]
  65 redirect to another page (and are thus considered legacy pages for providing
  66 stable URLs, for example) are linked to from other wiki pages.  This is useful
  67 w.r.t. backlinks.  Alternative, the backlinks to the \[[!meta redir]]-using
  68 pages could perhaps be passed on to the referred-to page?
  69
  70 ## Sendmail -- [[todo/passwordauth:_sendmail_interface]]
  71
  72 ## Parentlinks -- [[bugs/non-existing_pages_in_parentlinks]]
  73
  74 ## Discussion Pages of Discussion Pages of...
  75
  76 Is it useful to have Discussion pages of Discussion pages (etc.)?  -- On
  77 <http://www.gnu.org/software/hurd/hurd/building/cross-compiling/discussion.html>,
  78 this possibility is offered.
  79
  80 ## Modifying [[plugins/inline]] for showing only an *appetizer*
  81
  82 Currently ikiwiki's inline plugin will either show the full page or nothing of
  83 it.  Often that's too much.  One can manually use the [[plugins/toggle]] plugin
  84 -- see the *News* section on <http://www.gnu.org/software/hurd/>.  Adding a new
  85 mode to the inline plugin to only show an *appetizer* ending with *... (read
  86 on)* after a customizable amount of characters (or lines) would be a another
  87 possibility.  The *... (read on)* would then either toggle the full content
  88 being displayed or link to the complete page.
  89
  90 ## Prefix For the HTML Title
  91
  92 The title of each page (as in `<html><head><title>`...) should be prefixed with
  93 *GNU Project - GNU Hurd -*.  We can either do this directly in `page.tmpl`, or
  94 create a way to modify the `TITLE` template variable suitably.
  95
  96 ## Unverified -- these may be bugs, but have yet to be verified
  97
  98   * ikiwiki doesn't change its internal database when \[[!meta date]] /
  99     \[[!meta updated]] are added / removed, and thusly these meta values are
 100     not promulgated in RSS / Atom feeds.
 101
 102   * Complicated issue w.r.t. *no text was copied in this page*
 103     ([[plugins/cutpaste]]) in RSS feed (only; not Atom?) under some conditions
 104     (refresh only, but not rebuild?).  Perhaps missing to read in / parse some
 105     files?
 106
 107   * [[plugins/recentchanges]]
 108
 109       * Creates non-existing links to changes.
 110
 111       * Invalid *directory link* with `--usedirs`.
 112
 113       * Doesn't honor `$timeformat`.
 114
 115       * Does create `recentchangees.*` files even if that is overridden.