]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/commitdiff
more triage
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Wed, 25 Jul 2007 02:34:48 +0000 (02:34 +0000)
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Wed, 25 Jul 2007 02:34:48 +0000 (02:34 +0000)
doc/bugs.mdwn
doc/bugs/Does_not_support_non-UTF8_files.mdwn [deleted file]
doc/bugs/assumes_system_perl.mdwn [deleted file]
doc/bugs/discussion_removal.mdwn
doc/bugs/i18n_characters_in_post_title.mdwn [deleted file]
doc/todo/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn [new file with mode: 0644]
doc/todo/Does_not_support_non-UTF8_files.mdwn [new file with mode: 0644]
doc/todo/assumes_system_perl.mdwn [new file with mode: 0644]
doc/todo/should_use_a_standard_encoding_for_utf_chars_in_filenames.mdwn [new file with mode: 0644]
doc/usage.mdwn

index 2e06d7ca069118faf9ab72d3b4b08a1748f9cc0b..eb1f6d5496ea83a13af59e2eccd0e83822b8f9f1 100644 (file)
@@ -2,6 +2,7 @@ This is ikiwiki's bug list. Link bugs to [[bugs/done]] when done.
 
 Also see the [Debian bugs](http://bugs.debian.org/ikiwiki).
 
-[[inline pages="bugs/* and !bugs/done and !link(bugs/done) and !bugs/*/*"
+[[inline pages="bugs/* and !bugs/done and !bugs/discussion and 
+!link(bugs/done) and !bugs/*/*"
 feedpages="created_after(bugs/no_commit_mails_for_new_pages)"
 actions=yes rootpage="bugs" postformtext="Add a new bug titled:" show=0]]
diff --git a/doc/bugs/Does_not_support_non-UTF8_files.mdwn b/doc/bugs/Does_not_support_non-UTF8_files.mdwn
deleted file mode 100644 (file)
index 7d4cace..0000000
+++ /dev/null
@@ -1,5 +0,0 @@
-Ikiwiki does not seem to support non-UTF-8 file content, although there's no reason it should assume anything other than ASCII-compatibility from the encoding, at least if the Web interface is not used. It suffices that users use the same encoding as the templates specify. If I try to run it on `.mdwn` with content in ISO-8859-1 format, in an ISO-8859-1 locale, I get:
-
-    Malformed UTF-8 character (unexpected non-continuation byte 0x74, immediately after start byte 0xe4) in substitution iterator at /usr/local/share/perl/5.8.8/IkiWiki.pm line 640.
-
-I hope Ikiwiki is not part of the UTF-8 monoculturist movement...
diff --git a/doc/bugs/assumes_system_perl.mdwn b/doc/bugs/assumes_system_perl.mdwn
deleted file mode 100644 (file)
index 9df61bc..0000000
+++ /dev/null
@@ -1,14 +0,0 @@
-ikiwiki 1.45 doesn't work properly for perl installs not in the system path.
-
-ie:
-
-~/tools/perl-5.8.8/perl Makefile.PL
-make
-
-fails, as the 'make' command attempts to use the perl install in PATH, rather than the one ikiwiki is being installed for.
-
-The installed bin/ikiwiki file also refers to /usr/bin/perl rather than the perl it is being installed for.
-
-> I will acdept sufficiently nonintrusive patches to make ikiwiki work better on strange systems like
-> yours, but do not plan to work on it myself, since I do not use systems
-> where /usr/bin/perl is not a sane default. --[[Joey]]
index af3c6c1cb1526b2c93f52f1043be60040ce8f4a7..ef84a9b7451be46f0ebd96f979365befbf98a8e6 100644 (file)
@@ -1,3 +1,5 @@
 If a page has a discussion page, which is then removed, ikiwiki seems not
 to notice that the discussion page has gone away, and does not update the
 link to it in the action bar.
+
+> Reprocued with 2.5 --[[Joey]]
diff --git a/doc/bugs/i18n_characters_in_post_title.mdwn b/doc/bugs/i18n_characters_in_post_title.mdwn
deleted file mode 100644 (file)
index 8bd25bf..0000000
+++ /dev/null
@@ -1,59 +0,0 @@
-It seems that I can't use Polish characters in post title.
-When I try to do it, then I can see error message: "Błąd: bad page name".
-
-I hope it's a bug, not a feature and you fix it soon :) --[[Paweł|ptecza]]
-
-> ikiwiki only allows a very limited set of characters raw in page names,
-> this is done as a deny-by-default security thing. All other characters
-> need to be encoded in __code__ format, where "code" is the character
-> number. This is normally done for you, but if you're adding a page
-> manually, you need to handle it yourself. --[[Joey]]
-
->> Assume I have my own blog and I want to send a new post with Polish
->> characters in a title. I think it's totally normal and common thing
->> in our times. Do you want to tell me I shouldn't use my native
->> characters in the title? It can't be true ;)
-
->> In my opinion encoding of title is a job for the wiki engine,
->> not for me. Joey, please try to look at a problem from my point
->> of view. I'm only user and I don't have to understand
->> what the character number is. I only want to blog :)
-
->> BTW, why don't you use the modified-UTF7 coding for page names
->> as used in IMAP folder names with non-Latin letters? --[[Paweł|ptecza]]
-
->>> Joey, do you intend to fix that bug or it's a feature
->>> for you? ;) --[[Paweł|ptecza]]
-
->>>> Of course you can put Polish characters in the title. but the page
->>>> title and filename are not identical. Ikiwiki has to place some limits
->>>> on what filenames are legal to prevent abuse. Since
->>>> the safest thing to do in a security context is to deny by default and
->>>> only allow a few well-defined safe things, that's what it does, so
->>>> filenames are limited to basic alphanumeric characters.
->>>>
->>>> It's not especially hard to transform your title into get a legal
->>>> ikiwiki filename: 
-
-       joey@kodama:~>perl -MIkiWiki -le 'print IkiWiki::titlepage(shift).".mdwn"' "Błąd"
-       B__197____130____196____133__d.mdwn
-
->>>>> Thanks for the hint! It's good for me, but rather not for common users :)
-
->>>>>> Interesting... I have another result:
->>>>>>
->>>>>>        perl -MIkiWiki -le 'print IkiWiki::titlepage(shift).".mdwn"' "Błąd"
->>>>>>        B__179____177__d.mdwn
->>>>>>
->>>>>> What's your locale? I have both pl\_PL (ISO-8859-2) and pl\_PL.UTF-8,
->>>>>> but I use pl\_PL. Is it wrong? --[[Paweł|ptecza]]
-
->>>> Now, as to UTF7, in retrospect, using a standard encoding might be a
->>>> better idea than coming up with my own encoding for filenames. Can 
->>>> you provide a pointer to a description to modified-UTF7? --[[Joey]]
-
->>>>> The modified form of UTF7 is defined in [RFC 2060](http://www.ietf.org/rfc/rfc2060.txt)
->>>>> for IMAP4 protocol (please see section 5.1.3 for details).
-
->>>>> There is a Perl [Unicode::IMAPUtf7](http://search.cpan.org/~fabpot/Unicode-IMAPUtf7-2.01/lib/Unicode/IMAPUtf7.pm)
->>>>> module at the CPAN, but probably it hasn't been debianized yet :( --[[Paweł|ptecza]]
diff --git a/doc/todo/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn b/doc/todo/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn
new file mode 100644 (file)
index 0000000..3c89290
--- /dev/null
@@ -0,0 +1,78 @@
+I noticed when generating my wiki that all of my RSS feeds were
+getting regenerated even when I edited only a page that did not affect
+any feed.
+
+I found that the problem only occurs in the presence of a file that
+contains \[[inline pages="*"]].
+
+> How is this unexpected? By inlining _every_ page in the wiki, you're
+> making that page depend on every other page; any change to any page in
+> the wiki will result in the inlining page and its rss feed needing to be
+> updated to include the changed page.
+> 
+> At best, this is a [[wishlist]] optimisation item -- it would be nice if inline could
+> somehow know that since it's only displaying N pages, a change to the
+> N+1th page that its PageSpec matches is a no-op.
+> --[[Joey]]
+
+Here's a short script for replicating the bug. Just cut and paste this
+to a shell, (it will only muck in a new /tmp/ikiwiki-test directory
+that it will create):
+
+       cd /tmp
+       mkdir ikiwiki-test; cd ikiwiki-test; mkdir src
+       echo '\[[inline pages="blog/*"]]' > src/myblog.mdwn
+       mkdir src/blog; echo "A blog entry" > src/blog/entry.mdwn
+       echo 'use IkiWiki::Setup::Standard {
+               srcdir => "src",
+               destdir => "output",
+               url => "http://example.com",
+               templatedir => "/dev/null",
+               underlaydir => "/dev/null",
+               rss => 1,
+               wrappers => [],
+               verbose => 1,
+               refresh => 1
+       }' > setup
+       ikiwiki --setup setup
+       ls -l --time-style=full-iso output/myblog/index.rss
+       echo "not a blog entry" > src/not-a-blog.mdwn
+       ikiwiki --setup setup
+       ls -l --time-style=full-iso output/myblog/index.rss
+       echo '\[[inline pages="*"]]' > src/archives.mdwn
+       ikiwiki --setup setup
+       ls -l --time-style=full-iso output/myblog/index.rss
+       echo "still not blogging" >> src/not-a-blog.mdwn
+       ikiwiki --setup setup
+       ls -l --time-style=full-iso output/myblog/index.rss
+
+Here's the tail of the output that I see for this command:
+
+       $ echo "not a blog entry" > src/not-a-blog.mdwn
+       $ ikiwiki --setup setup
+       refreshing wiki..
+       scanning not-a-blog.mdwn
+       rendering not-a-blog.mdwn
+       done
+       $ ls -l --time-style=full-iso output/myblog/index.rss
+       -rw-r--r-- 1 cworth cworth 459 2007-06-01 06:34:36.000000000 -0700 output/myblog/index.rss
+       $ echo '\[[inline pages="*"]]' > src/archives.mdwn
+       $ ikiwiki --setup setup
+       refreshing wiki..
+       scanning archives.mdwn
+       rendering archives.mdwn
+       done
+       $ ls -l --time-style=full-iso output/myblog/index.rss
+       -rw-r--r-- 1 cworth cworth 459 2007-06-01 06:34:37.000000000 -0700 output/myblog/index.rss
+       $ echo "still not blogging" >> src/not-a-blog.mdwn
+       $ ikiwiki --setup setup
+       refreshing wiki..
+       scanning not-a-blog.mdwn
+       rendering not-a-blog.mdwn
+       rendering archives.mdwn, which depends on not-a-blog
+       done
+       $ ls -l --time-style=full-iso output/myblog/index.rss
+       -rw-r--r-- 1 cworth cworth 459 2007-06-01 06:34:38.000000000 -0700 output/myblog/index.rss
+
+It looks like the rendering of archives.mdwn is also silently
+generating myblog/index.rss.
diff --git a/doc/todo/Does_not_support_non-UTF8_files.mdwn b/doc/todo/Does_not_support_non-UTF8_files.mdwn
new file mode 100644 (file)
index 0000000..b78a5eb
--- /dev/null
@@ -0,0 +1,7 @@
+Ikiwiki does not seem to support non-UTF-8 file content, although there's no reason it should assume anything other than ASCII-compatibility from the encoding, at least if the Web interface is not used. It suffices that users use the same encoding as the templates specify. If I try to run it on `.mdwn` with content in ISO-8859-1 format, in an ISO-8859-1 locale, I get:
+
+    Malformed UTF-8 character (unexpected non-continuation byte 0x74, immediately after start byte 0xe4) in substitution iterator at /usr/local/share/perl/5.8.8/IkiWiki.pm line 640.
+
+I hope Ikiwiki is not part of the UTF-8 monoculturist movement...
+
+[[wishlist]]
diff --git a/doc/todo/assumes_system_perl.mdwn b/doc/todo/assumes_system_perl.mdwn
new file mode 100644 (file)
index 0000000..a040547
--- /dev/null
@@ -0,0 +1,16 @@
+ikiwiki 1.45 doesn't work properly for perl installs not in the system path.
+
+ie:
+
+~/tools/perl-5.8.8/perl Makefile.PL
+make
+
+fails, as the 'make' command attempts to use the perl install in PATH, rather than the one ikiwiki is being installed for.
+
+The installed bin/ikiwiki file also refers to /usr/bin/perl rather than the perl it is being installed for.
+
+> I will acdept sufficiently nonintrusive patches to make ikiwiki work better on strange systems like
+> yours, but do not plan to work on it myself, since I do not use systems
+> where /usr/bin/perl is not a sane default. --[[Joey]]
+
+[[wishlist]]
diff --git a/doc/todo/should_use_a_standard_encoding_for_utf_chars_in_filenames.mdwn b/doc/todo/should_use_a_standard_encoding_for_utf_chars_in_filenames.mdwn
new file mode 100644 (file)
index 0000000..a454d7d
--- /dev/null
@@ -0,0 +1,61 @@
+It seems that I can't use Polish characters in post title.
+When I try to do it, then I can see error message: "Błąd: bad page name".
+
+I hope it's a bug, not a feature and you fix it soon :) --[[Paweł|ptecza]]
+
+> ikiwiki only allows a very limited set of characters raw in page names,
+> this is done as a deny-by-default security thing. All other characters
+> need to be encoded in __code__ format, where "code" is the character
+> number. This is normally done for you, but if you're adding a page
+> manually, you need to handle it yourself. --[[Joey]]
+
+>> Assume I have my own blog and I want to send a new post with Polish
+>> characters in a title. I think it's totally normal and common thing
+>> in our times. Do you want to tell me I shouldn't use my native
+>> characters in the title? It can't be true ;)
+
+>> In my opinion encoding of title is a job for the wiki engine,
+>> not for me. Joey, please try to look at a problem from my point
+>> of view. I'm only user and I don't have to understand
+>> what the character number is. I only want to blog :)
+
+>> BTW, why don't you use the modified-UTF7 coding for page names
+>> as used in IMAP folder names with non-Latin letters? --[[Paweł|ptecza]]
+
+>>> Joey, do you intend to fix that bug or it's a feature
+>>> for you? ;) --[[Paweł|ptecza]]
+
+>>>> Of course you can put Polish characters in the title. but the page
+>>>> title and filename are not identical. Ikiwiki has to place some limits
+>>>> on what filenames are legal to prevent abuse. Since
+>>>> the safest thing to do in a security context is to deny by default and
+>>>> only allow a few well-defined safe things, that's what it does, so
+>>>> filenames are limited to basic alphanumeric characters.
+>>>>
+>>>> It's not especially hard to transform your title into get a legal
+>>>> ikiwiki filename: 
+
+       joey@kodama:~>perl -MIkiWiki -le 'print IkiWiki::titlepage(shift).".mdwn"' "Błąd"
+       B__197____130____196____133__d.mdwn
+
+>>>>> Thanks for the hint! It's good for me, but rather not for common users :)
+
+>>>>>> Interesting... I have another result:
+>>>>>>
+>>>>>>        perl -MIkiWiki -le 'print IkiWiki::titlepage(shift).".mdwn"' "Błąd"
+>>>>>>        B__179____177__d.mdwn
+>>>>>>
+>>>>>> What's your locale? I have both pl\_PL (ISO-8859-2) and pl\_PL.UTF-8,
+>>>>>> but I use pl\_PL. Is it wrong? --[[Paweł|ptecza]]
+
+>>>> Now, as to UTF7, in retrospect, using a standard encoding might be a
+>>>> better idea than coming up with my own encoding for filenames. Can 
+>>>> you provide a pointer to a description to modified-UTF7? --[[Joey]]
+
+>>>>> The modified form of UTF7 is defined in [RFC 2060](http://www.ietf.org/rfc/rfc2060.txt)
+>>>>> for IMAP4 protocol (please see section 5.1.3 for details).
+
+>>>>> There is a Perl [Unicode::IMAPUtf7](http://search.cpan.org/~fabpot/Unicode-IMAPUtf7-2.01/lib/Unicode/IMAPUtf7.pm)
+>>>>> module at the CPAN, but probably it hasn't been debianized yet :( --[[Paweł|ptecza]]
+
+[[wishlist]]
index 57cdba167dc89c27e2fe408f0da9186ccb16aff8..a8bb92d68cb48d2ba2121368d4ec3f23eba4c4a2 100644 (file)
@@ -236,8 +236,9 @@ configuration options of their own.
 
 * --numbacklinks n
 
-  Controls how many backlinks should be displayed maximum. Excess backlinks
-  will be hidden in a popup. Default is 10. Set to 0 to disable this feature.
+  Controls how many backlinks should be displayed at the bottom of a page.
+  Excess backlinks will be hidden in a popup. Default is 10. Set to 0 to
+  disable this feature.
 
 * --userdir subdir