aboutsummaryrefslogtreecommitdiff
path: root/doc/users/tschwinge.mdwn
blob: 0fe09696b17d024ba7563e4120d4959d46350475 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
[[!meta title="Thomas Schwinge"]]
# Thomas Schwinge

<tschwinge@gnu.org>  
<http://www.thomas.schwinge.homeip.net/>

I have converted the [GNU Hurd](http://www.gnu.org/software/hurd/)'s previous
web pages and previous wiki pages to a *[[ikiwiki]]* system; and all that while
preserving the previous content's history, which was stored in a CVS repository
for the HTML web pages and a TWiki RCS repository for the wiki; see
<http://www.gnu.org/software/hurd/colophon.html>.

# Issues to Work On

## Stability of Separate Builds

The goal is that separate builds of the same source files should yield the
exactly same HTML code (of course, except for changes due to differences in
Markdown rendering, for example).

  * Timestamps -- [[forum/ikiwiki__39__s_notion_of_time]], [[forum/How_does_ikiwiki_remember_times__63__]]

    Git set's the current *mtime* when checking out files.  The result is that
    <http://www.gnu.org/software/hurd/contact_us.html> and
    <http://www.bddebian.com:8888/~hurd-web/contact_us/> show different *Last
    edited* timestamps.

    This can either be solved by adding a facility to Git to set the
    checked-out files' *mtime* according to the *AuthorDate* / *CommitDate*
    (which one...), or doing that retroactively with the
    <http://www.gnu.org/software/hurd/set_mtimes> script before building, or
    with a ikiwiki-internal solution.

  * HTML character entities

    <http://www.gnu.org/software/hurd/purify_html>

## Tags -- [[bugs/tagged__40____41___matching_wikilinks]]

Tags should be a separate concept from wikilinks.

### \[[!map]] behavior

The \[[!map]] on, for example,
<http://www.gnu.org/software/hurd/tag/open_issue_hurd.html>, should not show
the complete hierarchy of pages, but instead just the pages that actually *do*
contain the \[[!tag open_issue_hurd]].

## Anchors -- [[ikiwiki/wikilink/discussion]]

## Default Content for Meta Values -- [[plugins/contrib/default_content_for___42__copyright__42___and___42__license__42__]]

This will decrease to be relevant, as we're going to add copyright and
licensing headers to every single file.

## Texinfo -- [[plugins/contrib/texinfo]]

Not very important.

## Shortcuts -- [[plugins/shortcut/discussion]]

## \[[!meta redir]] -- [[todo/__42__forward__42__ing_functionality_for_the_meta_plugin]]

Implement a checker that makes sure that no pages that use \[[!meta redir]]
redirect to another page (and are thus considered legacy pages for providing
stable URLs, for example) are linked to from other wiki pages.  This is useful
w.r.t. backlinks.  Alternative, the backlinks to the \[[!meta redir]]-using
pages could perhaps be passed on to the referred-to page?

## Sendmail -- [[todo/passwordauth:_sendmail_interface]]

## Parentlinks -- [[bugs/non-existing_pages_in_parentlinks]]

## Unverified -- these may be bugs, but have yet to be verified

  * ikiwiki doesn't change its internal database when \[[!meta date]] /
    \[[!meta updated]] are added / removed, and thusly these meta values are
    not promulgated in RSS / Atom feeds.