]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/todo/Add_space_before_slash_in_parent_links.mdwn
simplify
[git.ikiwiki.info.git] / doc / todo / Add_space_before_slash_in_parent_links.mdwn
index c4dc6ede6b7724e2db86a4e4b3534492e30c3173..afb0d55767419eddef7c355e4392c5efc12c80f4 100644 (file)
@@ -1,4 +1,17 @@
-This patch adds a space before the forward-slash in the the parent links. There is already a space after the slash.
+This [[patch]] adds a space before the forward-slash in the the parent links. There is already a space after the slash.
+
+> I intentionally put the space after the slash and not before, because I
+> like how it looks that way. So I don't plan to apply this patch unless a
+> lot of people disagree with me or whatever. --[[Joey]]
+
+>> Couldn't we export what's put between the links to a variable? For instance, I might actually want to set it to ' : ' or '→'. --[[madduck]]
+
+>>> Yes, please.  This seems to be something a lot of people want to customize.  (I certainly do -- a forward slash only looks natural to Unix users)  --[[sabr]]
+
+>> Joey, would I be right to summarize your position on this as "people who
+>> want to change the text of the templates should maintain their own version
+>> of the `.tmpl` files"? It's not clear to me how this todo item could be
+>> closed in a way acceptable to you, except perhaps as WONTFIX. --[[smcv]]
 
 Before:
 
@@ -11,40 +24,118 @@ After:
 Patch:
 
     diff --git a/templates/misc.tmpl b/templates/misc.tmpl
-    index 80e6d0b..184920e 100644
+    index 184920e..80e6d0b 100644
     --- a/templates/misc.tmpl
     +++ b/templates/misc.tmpl
     @@ -15,7 +15,7 @@
 
      <div class="header">
      <span>
-    -<TMPL_VAR INDEXLINK> / <TMPL_VAR TITLE>
-    +<TMPL_VAR INDEXLINK>/ <TMPL_VAR TITLE>
+    -<TMPL_VAR INDEXLINK>/ <TMPL_VAR TITLE>
+    +<TMPL_VAR INDEXLINK> / <TMPL_VAR TITLE>
      </span>
      </div>
 
     diff --git a/templates/page.tmpl b/templates/page.tmpl
-    index 1978e93..3a1ac9e 100644
+    index 3a1ac9e..1978e93 100644
     --- a/templates/page.tmpl
     +++ b/templates/page.tmpl
     @@ -17,7 +17,7 @@
      <div class="header">
      <span>
      <TMPL_LOOP NAME="PARENTLINKS">
-    -<a href="<TMPL_VAR NAME=URL>"><TMPL_VAR NAME=PAGE></a> /
-    +<a href="<TMPL_VAR NAME=URL>"><TMPL_VAR NAME=PAGE></a>/
+    -<a href="<TMPL_VAR NAME=URL>"><TMPL_VAR NAME=PAGE></a>/
+    +<a href="<TMPL_VAR NAME=URL>"><TMPL_VAR NAME=PAGE></a> /
      </TMPL_LOOP>
      <TMPL_VAR TITLE>
      </span>
     diff --git a/templates/recentchanges.tmpl b/templates/recentchanges.tmpl
-    index 4877395..e03482f 100644
+    index e03482f..4877395 100644
     --- a/templates/recentchanges.tmpl
     +++ b/templates/recentchanges.tmpl
     @@ -15,7 +15,7 @@
 
      <div class="header">
      <span>
-    -<TMPL_VAR INDEXLINK> / <TMPL_VAR TITLE>
-    +<TMPL_VAR INDEXLINK>/ <TMPL_VAR TITLE>
+    -<TMPL_VAR INDEXLINK>/ <TMPL_VAR TITLE>
+    +<TMPL_VAR INDEXLINK> / <TMPL_VAR TITLE>
      </span>
      </div>
+
+----
+
+It's almost implicit in some of the discussion above but this can be achieved locally if you fork your templates directory from ikiwiki's, with an ammendment such as
+
+    <h1><TMPL_LOOP NAME="PARENTLINKS"><a
+        href="<TMPL_VAR NAME=URL>"><TMPL_VAR NAME=PAGE></a>
+        &rarr;
+        </TMPL_LOOP><TMPL_VAR TITLE></h1>
+
+This is what I do on my site for example. -- [[Jon]]
+
+> You don't actually need to fork the whole directory, "only" `page.tmpl` -
+> put `templatedir => "/foo/templates"` in your setup file, copy `page.tmpl`
+> to that directory, and modify it there. IkiWiki will look in `templatedir`
+> first, then fall back to its default templates if any are missing from
+> `templatedir`.
+>
+> (Admittedly, `page.tmpl` is the hardest to maintain a fork of, because it
+> tends to change whenever a new plugin is added...) --[[smcv]]
+
+----
+
+Here is a solution which doesn't require people to create their own `page.tmpl`.  The solution uses an HTML list together with CSS to draw the separator and can therefore be controlled by users.  This change also allows people to control other aspects of how the parentlinks are displayed.  The only drawback is that lynx/w3m don't seem to deal with this CSS feature, but I don't think it's too bad since the parentlinks will simply show up as a list.
+
+(I see that the other patch changes templates/misc.tmpl and templates/recentchanges.tmpl for INDEXLINK.  I haven't done that but can do so if [[Joey]] likes this approach.)
+
+--[[tbm]]
+
+    diff --git a/doc/style.css b/doc/style.css
+    index 35a1331..b726365 100644
+    --- a/doc/style.css
+    +++ b/doc/style.css
+    @@ -129,6 +129,23 @@ pre {
+        overflow: auto;
+     }
+
+    +ul.parentlinks li:after {
+    +display: marker;
+    +content: "/ ";
+    +background: none;
+    +}
+    +
+    +ul.parentlinks li {
+    +display: inline;
+    +}
+    +
+    +ul.parentlinks
+    +{
+    +padding-left: 0;
+    +display:inline;
+    +list-style-type: none;
+    +}
+    +
+     div.recentchanges {
+        border-style: solid;
+        border-width: 1px;
+    diff --git a/templates/page.tmpl b/templates/page.tmpl
+    index 770ac23..f54493e 100644
+    --- a/templates/page.tmpl
+    +++ b/templates/page.tmpl
+    @@ -44,11 +44,15 @@
+     <TMPL_IF HTML5><section class="pageheader"><TMPL_ELSE><div class="pageheader"></TMPL_IF>
+     <TMPL_IF HTML5><header class="header"><TMPL_ELSE><div class="header"></TMPL_IF>
+     <span>
+    +<TMPL_IF PARENTLINKS>
+     <span class="parentlinks">
+    +<ul class="parentlinks">
+     <TMPL_LOOP PARENTLINKS>
+    -<a href="<TMPL_VAR URL>"><TMPL_VAR PAGE></a>/
+    +<li><a href="<TMPL_VAR URL>"><TMPL_VAR PAGE></a></li>
+     </TMPL_LOOP>
+    +</ul>
+     </span>
+    +</TMPL_IF>
+     <span class="title">
+     <TMPL_VAR TITLE>
+     <TMPL_IF ISTRANSLATION>