diff options
author | Joey Hess <joey@kodama.kitenet.net> | 2008-08-25 14:19:39 -0400 |
---|---|---|
committer | Joey Hess <joey@kodama.kitenet.net> | 2008-08-25 14:19:39 -0400 |
commit | d6fd1f1cc878b5dffdfae30f6dfee77c235c438e (patch) | |
tree | ae0e8d689bec3a0471385864056d68b6629427f7 /doc/todo | |
parent | 9867806c13b97c0f4ce1850ee4d43c6fe3a926e7 (diff) | |
download | ikiwiki-d6fd1f1cc878b5dffdfae30f6dfee77c235c438e.tar ikiwiki-d6fd1f1cc878b5dffdfae30f6dfee77c235c438e.tar.gz |
rename preprocessordirective to directive
Reasons include:
- easier to type
- might want postprocessor directives again sometime, and listdirectives
can then use the directive/* files for either
- that it's done as a preprocessor step is an internal detail (and not a
very accurate one, really :-)
Diffstat (limited to 'doc/todo')
-rw-r--r-- | doc/todo/Add_a_plugin_to_list_available_pre-processor_commands.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/conditional_text_based_on_ikiwiki_features.mdwn | 4 | ||||
-rw-r--r-- | doc/todo/format_escape.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/graphviz.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/htmlvalidation.mdwn | 4 | ||||
-rw-r--r-- | doc/todo/latex.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/linktitle.mdwn | 6 | ||||
-rw-r--r-- | doc/todo/pageindexes.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/preprocessor_directive_for_proposed_changes.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/progressbar_plugin.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/rss_title_description.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/shortcut_link_text.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/smileys_do_not_work_in_PreprocessorDirective_arguments.mdwn | 6 |
13 files changed, 20 insertions, 18 deletions
diff --git a/doc/todo/Add_a_plugin_to_list_available_pre-processor_commands.mdwn b/doc/todo/Add_a_plugin_to_list_available_pre-processor_commands.mdwn index 0524627d4..b8ef2409d 100644 --- a/doc/todo/Add_a_plugin_to_list_available_pre-processor_commands.mdwn +++ b/doc/todo/Add_a_plugin_to_list_available_pre-processor_commands.mdwn @@ -412,3 +412,5 @@ This is what I was using for `preprocessor-description.tmpl`: The <TMPL_VAR plugin> preprocessor command currently has no description. Maybe you should edit this page to add one. + +[[tag done]] diff --git a/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn b/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn index 4bdcf3d01..17585af65 100644 --- a/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn +++ b/doc/todo/conditional_text_based_on_ikiwiki_features.mdwn @@ -25,7 +25,7 @@ include an `else` clause; if so, you could label the text used if true as `then`. Syntax could vary greatly here, both for the -[[ikiwiki/PreprocessorDirective]] and for the condition itself. +[[ikiwiki/Directive]] and for the condition itself. > I think this is a good thing to consider, although conditionals tend to > make everything a lot more complicated, so I also want to KISS, and not @@ -57,7 +57,7 @@ Syntax could vary greatly here, both for the > --[[Joey]] >> [[ikiwiki/PageSpec]] syntax seems perfect, and your proposed syntax for the `if` ->> [[ikiwiki/PreprocessorDirective]] looks fine to me. +>> [[ikiwiki/Directive]] looks fine to me. >> >> [[ikiwiki/PageSpec]]s don't give you `none` for free, since `!foo/*` as a boolean >> would mean "does any page not matching `foo/*` exist", not "does `foo/*` diff --git a/doc/todo/format_escape.mdwn b/doc/todo/format_escape.mdwn index 315b2d88f..8dfe05581 100644 --- a/doc/todo/format_escape.mdwn +++ b/doc/todo/format_escape.mdwn @@ -219,7 +219,7 @@ Index: doc/plugins/rst.mdwn -* reStructuredText does not allow raw html to be inserted into - documents, but ikiwiki does so in many cases, including - [[WikiLinks|ikiwiki/WikiLink]] and many -- [[PreprocessorDirectives|ikiwiki/PreprocessorDirective]]. +- [[Directives|ikiwiki/Directive]]. +* Some bits of ikiwiki may still assume that markdown is used or embed html + in ways that break reStructuredText. (Report bugs if you find any.) * It's slow; it forks a copy of python for each page. While there is a diff --git a/doc/todo/graphviz.mdwn b/doc/todo/graphviz.mdwn index 66ca0ae32..3f2514a99 100644 --- a/doc/todo/graphviz.mdwn +++ b/doc/todo/graphviz.mdwn @@ -1,5 +1,5 @@ How about a plugin providing a -[[preprocessor_directive|ikiwiki/preprocessordirective]] to render a +[[preprocessor_directive|ikiwiki/directive]] to render a [[!debpkg graphviz]] file as an image via one of the graphviz programs ("dot" by default) and include the resulting image on the page, using the "cmapx" image map format? graphviz files themselves could also render the diff --git a/doc/todo/htmlvalidation.mdwn b/doc/todo/htmlvalidation.mdwn index 96bcd926b..e376b840e 100644 --- a/doc/todo/htmlvalidation.mdwn +++ b/doc/todo/htmlvalidation.mdwn @@ -31,8 +31,8 @@ Because [ [inlinepage] ] isn't separated by a blank line it gets treated as a block-level element. Hmm, will this stop all formatting, including *'s to em-tags? --[[JeroenSchot]] Ah didn't realize you meant it fixed it at the markdown level. I'll - think about making postprocessordirectives into - [[ikiwiki/preprocessordirective]]s instead, then I could use that fix (but I'm not + think about making postprocessor directives into + preprocessor directives instead, then I could use that fix (but I'm not sure how feasible it is to do that). --[[Joey]] Done.. inlining is now a preprocessor directive, happens before diff --git a/doc/todo/latex.mdwn b/doc/todo/latex.mdwn index e96e4b782..56d3b1c0c 100644 --- a/doc/todo/latex.mdwn +++ b/doc/todo/latex.mdwn @@ -1,5 +1,5 @@ How about a plugin adding a -[[preprocessor_directive|ikiwiki/preprocessordirective]] to render some given LaTeX +[[preprocessor_directive|ikiwiki/directive]] to render some given LaTeX and include it in the page? This could either render the LaTeX as a PNG via [[!debpkg dvipng]] and include the resulting image in the page, or perhaps render via [HeVeA](http://pauillac.inria.fr/~maranget/hevea/index.html), diff --git a/doc/todo/linktitle.mdwn b/doc/todo/linktitle.mdwn index d5b53e082..6df3bfdce 100644 --- a/doc/todo/linktitle.mdwn +++ b/doc/todo/linktitle.mdwn @@ -2,15 +2,15 @@ Pages could have a `linktitle` (perhaps via [[plugins/meta]]), and [[wikilinks|ikiwiki/wikilink]] could use that title by default when linking to the page. That would allow pages to have a simple, easily linkable name (without spaces, for instance), but use the proper title for links. For -example, [[ikiwiki/PreprocessorDirective]] could use the `linktitle` +example, [[ikiwiki/Directive]] could use the `linktitle` "preprocessor directive", and pages for [[users]] could have `linktitle`s that put spaces in their names. Ideally, perhaps two versions of the title could exist, one for general use, and an optional one for if the case in the actual link starts with an -uppercase letter. That would allow [[ikiwiki/preprocessordirective]] to +uppercase letter. That would allow [[ikiwiki/directive]] to use the link text "preprocessor directive", but -[[ikiwiki/PreprocessorDirective]] to use the link text "Preprocessor +[[ikiwiki/Directive]] to use the link text "Preprocessor Directive", for use at the beginnings of sentences. If the second version did not exist, the first version would apply to both cases. However, that also seems like potential overkill, and less important than the basic diff --git a/doc/todo/pageindexes.mdwn b/doc/todo/pageindexes.mdwn index c2de20a34..cf28bec96 100644 --- a/doc/todo/pageindexes.mdwn +++ b/doc/todo/pageindexes.mdwn @@ -1,5 +1,5 @@ Might be nice to support automatically generating an index based on headers in a page, for long pages. This could be done as a sanitize hook that -parsed the html, with a preprocessordirective that controlled it. +parsed the html, with a directive that controlled it. [[todo/done]] diff --git a/doc/todo/preprocessor_directive_for_proposed_changes.mdwn b/doc/todo/preprocessor_directive_for_proposed_changes.mdwn index c0af59eba..1542f39ae 100644 --- a/doc/todo/preprocessor_directive_for_proposed_changes.mdwn +++ b/doc/todo/preprocessor_directive_for_proposed_changes.mdwn @@ -7,7 +7,7 @@ which can't be made through the web interface: Of course in these cases, you can add your request to a discussion page and wait for someone with the access/confidence to apply them. -Maybe this can be enhanced with a [[ikiwiki/PreprocessorDirective]]: +Maybe this can be enhanced with a [[ikiwiki/Directive]]: <pre> \[[!suggest op=merge dstfile=trunk srcfile=branches/jk oldrev=1234 newrev=1342]] diff --git a/doc/todo/progressbar_plugin.mdwn b/doc/todo/progressbar_plugin.mdwn index 4f3cf148b..3401bca85 100644 --- a/doc/todo/progressbar_plugin.mdwn +++ b/doc/todo/progressbar_plugin.mdwn @@ -209,7 +209,7 @@ Here is a potential documentation page: [[!template id=plugin name=progress author="[[Will]]"]] [[!tag type/meta]] -Provides a \\[[!progress ]] [[ikiwiki/PreProcessorDirective]] that is +Provides a \\[[!progress ]] [[ikiwiki/Directive]] that is replaced with a progress bar. There are two possible parameter sets. The first is a single parameter diff --git a/doc/todo/rss_title_description.mdwn b/doc/todo/rss_title_description.mdwn index 3f56a10e0..f0138cb72 100644 --- a/doc/todo/rss_title_description.mdwn +++ b/doc/todo/rss_title_description.mdwn @@ -18,7 +18,7 @@ A few pointers and I might be able to implement this myself. -- JamesWestby > Now, the description field currently defaults to the wiki name, > and that could indeed stand to be made configurable. Since the > current (svn) version of ikiwiki supports long, word-wrapped -> blocks of text as parameters to [[ikiwiki/PreProcessorDirective]]s, seems +> blocks of text as parameters to [[ikiwiki/Directive]]s, seems > to me the best way would be to simple modify inline.pm to make the > descripion configurable by such parameter, with a fallback to the > wiki name. You'll need to modify rsspage.tmpl to use whatever new diff --git a/doc/todo/shortcut_link_text.mdwn b/doc/todo/shortcut_link_text.mdwn index 765c445ab..952e84608 100644 --- a/doc/todo/shortcut_link_text.mdwn +++ b/doc/todo/shortcut_link_text.mdwn @@ -1,4 +1,4 @@ -[[plugins/shortcut]] creates link shortcut [[ikiwiki/PreprocessorDirective]]s, +[[plugins/shortcut]] creates link shortcut [[ikiwiki/Directive]]s, which substitute their argument into the specified shortcut URL to generate the link target, and use the argument as the link text. For example, given the example [[shortcuts]], `\[[!wikipedia ikiwiki]]` generates a link to diff --git a/doc/todo/smileys_do_not_work_in_PreprocessorDirective_arguments.mdwn b/doc/todo/smileys_do_not_work_in_PreprocessorDirective_arguments.mdwn index a55a66141..06c06e191 100644 --- a/doc/todo/smileys_do_not_work_in_PreprocessorDirective_arguments.mdwn +++ b/doc/todo/smileys_do_not_work_in_PreprocessorDirective_arguments.mdwn @@ -1,11 +1,11 @@ -Several [[ikiwiki/PreprocessorDirective]]s take ikiwiki-formatted text as arguments, +Several [[ikiwiki/Directive]]s take ikiwiki-formatted text as arguments, such as the `then` and `else` arguments of the new `if` directive, or the `desc` argument of the `shortcut` directive. However, smileys do not work in these arguments. -Since the arguments to [[ikiwiki/PreprocessorDirective]]s might use the same syntax as +Since the arguments to [[ikiwiki/Directive]]s might use the same syntax as smileys for a different meaning, smiley substitution should not happen until -after [[ikiwiki/PreprocessorDirective]]s. +after [[ikiwiki/Directive]]s. --[[JoshTriplett]] |