Re: [emacs-wiki-discuss] Re: can you help me with some formatting issues

[Joe Corneli]

   > feature for escaping WikiWords in emacs-wiki?

   <nop>WebTops

Great, thanks.  I was reading the documentation inside of
emacs-wiki-mode, so this tag didn't catch my eye...

 To prevent a link name (of any type) from being treated as such,
 surround it with =equals= (to display it in monotype), or prefix
 it with the tag <nop>.

While it isn't an excuse for not reading the documentation, the word
"escape" might be a helpful synonym to use in this context (useful
for people searching the docs for keywords).  E.g.  you might

 To prevent a link name (of any type) from being treated as such,
 surround it with =equals= (this will display the text in monotype), or prefix 
it
 with the tag <nop> (this will escape linking but keep the link in the
 surrounding font).


   > The `mailto' links, e.g. [[mailto:address@hidden aren't
   > coming up as links.  What is the preferred way to link to an email
   > address.

   mailto:address@hidden and [[mailto:address@hidden work here.
   The <, however, is confusing it. < is reserved for tags. Try

Interesting.  I happened to notice that `_' also breaks linking.  By
contrast, it appears that you can have any number of `[' characters
and not break linking; check this out.

 [[[[[[[[mailto:address@hidden@nongnu.org]]


   Announce List  &lt;[[mailto:address@hidden&gt; 
http://mail.nongnu.org/mailman/listinfo/fle3-announce

Not my fav.

   Announce List  (mailto:address@hidden); 
http://mail.nongnu.org/mailman/listinfo/fle3-announce

That's better, but what I used was

   Announce List  | ([[mailto:address@hidden@nongnu.org]]) | 
http://mail.nongnu.org/mailman/listinfo/fle3-announce

Please note that this still has some problems.  Please see

       http://www.ma.utexas.edu/~jcorneli/y/FLE3.html
       http://www.ma.utexas.edu/~jcorneli/y/FLE3.txt

I think it would be nice if `mailto:' (as in your second example)
automatically rewrote the link lable as I have it by hand above.
This might just be personal preference.

   > The link [[All Packages in Directory]] doesn't render as a link at
   > all. Nor does address@hidden (another attempt at making an
   > email address link) nor [[Web Authoring]] nor [[Knowledge base]].

   No spaces allowed in page names (sorry!). Try [[Knowledgebase]], or
   [[WebAuthoring][Web Authoring]]. If spaces are particularly important
   to you, we can figure out how to hack it in.

Well, it is tedious to have to write many variations on

 [[Web_Authoring][Web Authoring]]

in one page.  I think I was mislead by the line in the documentation
that reads

 [[link text][optional link description]]

!  And it only took a few weeks of writing Oddmuse to make me forget
particulars about how emacs-wiki works.

   mailto: is handled by the browse-url function.

Good.

   New versions at http://sacha.free.net.ph/notebook/emacs/emacs-wiki/

Got one, and some add ons.  But note that  

  ;; Version: $Version$

is not so helpful.  (I think adding a date along with the version
_number_ would be keen.)

   > Finally, is there an emacs-wiki Wiki?  (Perhaps that has also been
   > exported to a texinfo file?)  I think it would be nice to have if
   > not.

   http://www.emacswiki.org/cgi-bin/wiki/PlannerMode and
   http://www.emacswiki.org/cgi-bin/wiki/EmacsWikiMode ?

Not really quite what I had in mind, though of course there's no
reason it couldn't evolve the way I was thinking.  I guess I was
hoping for something more like a traditional manual.  A discussion
of how to use httpd-serve (and an up-to-date link) would be
especially nice. (I'm not saying I necessarily would use
httpd-serve, but would at least like to take a look at the info page
and the code.)

   Tables can be rendered nicely if you mark them up as

   Web page           | http://fle3.uiah.fi/
   Source tarball     | http://fle3.uiah.fi/download/fle_1.4.3.tar.gz
   Source information | http://fle3.uiah.fi/download/

Thanks, that is quite good.  But it only seems to work well for
2-column tables. (See the links I included above.)

   >    Version 1.4.3 (stable) released on 2003-06-13
   >    Licensed under [[The GNU General Public License, Version 2 or later]].
   >    This is not a GNU package.

   Licensed under [[GPL2][The GNU General Public License, Version 2 or later]].
   and then make GPL2.

Again, spaces in link names would be pleasant.