From 07b28cfcf98c40d1c45276b18d09aab3fa491103 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge <tschwinge@gnu.org> Date: Fri, 16 Oct 2009 11:24:21 +0200 Subject: TODO: How to preview changes before git://... commit. --- doc/todo/preview_changes_before_git_commit.mdwn | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 doc/todo/preview_changes_before_git_commit.mdwn diff --git a/doc/todo/preview_changes_before_git_commit.mdwn b/doc/todo/preview_changes_before_git_commit.mdwn new file mode 100644 index 000000000..e0e6ba866 --- /dev/null +++ b/doc/todo/preview_changes_before_git_commit.mdwn @@ -0,0 +1,7 @@ +ikiwiki allows to commit changes to the doc wiki over the `git://...` protocol. +It would be nice if there'd be a uniform way to view these changes before `git +push`ing. For the GNU Hurd's web pages, we include a *render_locally* script, +<http://www.gnu.org/software/hurd/render_locally>, with instructions on +<http://www.gnu.org/software/hurd/contributing/web_pages.html>, section +*Preview Changes*. With ikiwiki, one can use `make docwiki`, but that excludes +a set of pages, as per `docwiki.setup`. --[[tschwinge]] -- cgit v1.2.3 From a91bfd55069a0131d46937a8ef9eedc38e8d6de9 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge <tschwinge@gnu.org> Date: Fri, 16 Oct 2009 11:25:23 +0200 Subject: Sign. --- doc/bugs/non-existing_pages_in_parentlinks.mdwn | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/bugs/non-existing_pages_in_parentlinks.mdwn b/doc/bugs/non-existing_pages_in_parentlinks.mdwn index 532b0acca..b4ea42b17 100644 --- a/doc/bugs/non-existing_pages_in_parentlinks.mdwn +++ b/doc/bugs/non-existing_pages_in_parentlinks.mdwn @@ -2,4 +2,4 @@ Then, on <http://www.gnu.org/software/hurd/hurd/translator/writing/example.html>, in the *parentlinks* line, *writing* links to the top-level *index* file. It should -rather not link anywhere at all. +rather not link anywhere at all. --[[tschwinge]] -- cgit v1.2.3 From 027d28a6a1795b5b1b81aa381793f225682cc0e5 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge <tschwinge@gnu.org> Date: Fri, 16 Oct 2009 11:28:06 +0200 Subject: Link to the forum from the top-level page. --- doc/index.mdwn | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/index.mdwn b/doc/index.mdwn index 93526c42c..732cf7a89 100644 --- a/doc/index.mdwn +++ b/doc/index.mdwn @@ -20,6 +20,7 @@ ikiwiki [[!version ]]. ## developer resources The [[RoadMap]] describes where the project is going. +The [[forum]] is open for discussions. [[Bugs]], [[TODO]] items, [[wishlist]] items, and [[patches|patch]] can be submitted and tracked using this wiki. -- cgit v1.2.3 From 3cf62292e11f0a8809f9f53f1be77acd80d0fb43 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge <tschwinge@gnu.org> Date: Fri, 16 Oct 2009 11:33:42 +0200 Subject: Forum: discussion about the ever-growing list of pages. --- doc/forum/ever-growing_list_of_pages.mdwn | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 doc/forum/ever-growing_list_of_pages.mdwn diff --git a/doc/forum/ever-growing_list_of_pages.mdwn b/doc/forum/ever-growing_list_of_pages.mdwn new file mode 100644 index 000000000..84b9fe6ee --- /dev/null +++ b/doc/forum/ever-growing_list_of_pages.mdwn @@ -0,0 +1,12 @@ +What is overyone's idea about the ever-growing list of pages in bugs/ etc.? +Once linked to `done`, they're removed from the rendered [[bugs]] page -- but +they're still present in the repository. + +Shouldn't there be some clean-up at some point for those that have been +resolved? Or should all of them be kept online forever? + +Likewise, for example in [[forum/ikiwiki__39__s_notion_of_time]], should one +remove the text about the implementation bug that has been fixed, or should it +stay there, for reference? + +--[[tschwinge]] -- cgit v1.2.3 From 9da02428d4f62f84bdadc15f6aadf553a9d16c58 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge <tschwinge@gnu.org> 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(+) 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 <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. + ## 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 <tschwinge@gnu.org> Date: Fri, 16 Oct 2009 11:46:27 +0200 Subject: Prefixing the HTML Title. --- doc/users/tschwinge.mdwn | 6 ++++++ 1 file changed, 6 insertions(+) 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 `<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. + ## 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(+) 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(+) 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(-) 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