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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
[[!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]]
## Discussion Pages of Discussion Pages of...
Is it useful to have Discussion pages of Discussion pages (etc.)? -- On
<http://www.gnu.org/software/hurd/hurd/building/cross-compiling/discussion.html>,
this possibility is offered.
## Modifying [[plugins/inline]] for showing only an *appetizer*
Currently ikiwiki's inline plugin will either show the full page or nothing of
it. Often that's too much. One can manually use the [[plugins/toggle]] plugin
-- see the *News* section on <http://www.gnu.org/software/hurd/>. Adding a new
mode to the inline plugin to only show an *appetizer* ending with *... (read
on)* after a customizable amount of characters (or lines) would be a another
possibility. The *... (read on)* would then either toggle the full content
being displayed or link to the complete page.
## Prefix For the HTML Title
The title of each page (as in `<html><head><title>`...) should be prefixed with
*GNU Project - GNU Hurd -*. We can either do this directly in `page.tmpl`, or
create a way to modify the `TITLE` template variable suitably.
## [[plugins/inline]] feedfile option
Not that important. Git commit b67632cdcdd333cf0a88d03c0f7e6e62921f32c3. This
would be nice to have even when using *usedirs*. Might involve issues as
discussed in *N-to-M Mapping of Input and Output Files* on
[[plugins/contrib/texinfo]].
## 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.
* Complicated issue w.r.t. *no text was copied in this page*
([[plugins/cutpaste]]) in RSS feed (only; not Atom?) under some conditions
(refresh only, but not rebuild?). Perhaps missing to read in / parse some
files?
* [[plugins/recentchanges]]
* Creates non-existing links to changes.
* Invalid *directory link* with `--usedirs`.
* Doesn't honor `$timeformat`.
* Does create `recentchangees.*` files even if that is overridden.
|