From 3e2f99cba10e2bf9194a5788b4174844aeb566e3 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Fri, 16 Oct 2009 11:01:22 +0200 Subject: A list of stuff that would be nice to work on for enhancing the GNU Hurd web pages. --- doc/users/tschwinge.mdwn | 61 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index bb5cef6a6..5953cf802 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -9,3 +9,64 @@ 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 . + +# 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 + and + 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 + script before building, or + with a ikiwiki-internal solution. + + * HTML character entities + + + +## Tags -- [[bugs/tagged__40____41___matching_wikilinks]] + +Tags should be a separate concept from wikilinks. + +### \[[!map]] behavior + +The \[[!map]] on, for example, +, 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]] -- cgit v1.2.3 From 7d76e36edd27663ae7fca653f36a08a63cb36c50 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Fri, 16 Oct 2009 11:05:51 +0200 Subject: Issue with [[!meta date]] / [[!meta updated]] vs. RSS / Atom feeds? --- doc/users/tschwinge.mdwn | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 5953cf802..0fe09696b 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -70,3 +70,9 @@ 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. -- cgit v1.2.3 From b94d9589d39dfa720231fb982340741a139478cf Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Fri, 16 Oct 2009 11:11:59 +0200 Subject: Issue with ``no text was copied in this page'' in RSS feeds? --- doc/users/tschwinge.mdwn | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 0fe09696b..306338ae4 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -76,3 +76,8 @@ pages could perhaps be passed on to the referred-to page? * 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? -- cgit v1.2.3 From ab68f96494409e4ce8f689b5c27ef9ea3a73172c Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Fri, 16 Oct 2009 11:12:28 +0200 Subject: Discussion pages of Discussion pages (etc.)? --- doc/users/tschwinge.mdwn | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 306338ae4..657de85f3 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -71,6 +71,12 @@ pages could perhaps be passed on to the referred-to page? ## 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 +, +this possibility is offered. + ## Unverified -- these may be bugs, but have yet to be verified * ikiwiki doesn't change its internal database when \[[!meta date]] / -- cgit v1.2.3 From 9da02428d4f62f84bdadc15f6aadf553a9d16c58 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Fri, 16 Oct 2009 11:40:35 +0200 Subject: Appetizer for the inline plugin? --- doc/users/tschwinge.mdwn | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 657de85f3..54614e922 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -77,6 +77,16 @@ Is it useful to have Discussion pages of Discussion pages (etc.)? -- On , 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 . 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. + ## Unverified -- these may be bugs, but have yet to be verified * ikiwiki doesn't change its internal database when \[[!meta date]] / -- cgit v1.2.3 From 1c3fc89b8462e4cef2d3fa92dc55c4a9a0658aac Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Fri, 16 Oct 2009 11:46:27 +0200 Subject: Prefixing the HTML Title. --- doc/users/tschwinge.mdwn | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 54614e922..384fac09d 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -87,6 +87,12 @@ 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 ``...) 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. + ## Unverified -- these may be bugs, but have yet to be verified * ikiwiki doesn't change its internal database when \[[!meta date]] / -- cgit v1.2.3 From 53bf9301eab668cb448cf42a318647dc892a2985 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge <tschwinge@gnu.org> Date: Fri, 16 Oct 2009 11:48:26 +0200 Subject: Potential issues with the recentchanges plugin. --- doc/users/tschwinge.mdwn | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 384fac09d..05587a24c 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -103,3 +103,13 @@ create a way to modify the `TITLE` template variable suitably. ([[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. -- cgit v1.2.3 From d352af1da54851cb7dfdcb31664ad43ecfa3ae85 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge <tschwinge@gnu.org> Date: Fri, 16 Oct 2009 11:53:37 +0200 Subject: inline plugin: feedfile option w/ usedirs. --- doc/users/tschwinge.mdwn | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 05587a24c..7220310f3 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -93,6 +93,13 @@ 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]] / -- cgit v1.2.3 From 5757ad87740fc50ead02aa06cadeb8b591dfcb82 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge <tschwinge@gnu.org> Date: Fri, 16 Oct 2009 11:57:49 +0200 Subject: Add a comment about the texinfo plugin. --- doc/users/tschwinge.mdwn | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'doc/users') diff --git a/doc/users/tschwinge.mdwn b/doc/users/tschwinge.mdwn index 7220310f3..80eeae0c5 100644 --- a/doc/users/tschwinge.mdwn +++ b/doc/users/tschwinge.mdwn @@ -55,7 +55,8 @@ licensing headers to every single file. ## Texinfo -- [[plugins/contrib/texinfo]] -Not very important. +Not very important. Have to consider external commands / files / security (see +[[plugins/teximg]] source code)? ## Shortcuts -- [[plugins/shortcut/discussion]] -- cgit v1.2.3