On Jul 29, 2013 4:59 PM, "Ben Fritz" <fritzophrenic@gmail.com> wrote:
  >
  > On Tuesday, July 23, 2013 10:11:56 PM UTC-5, ZyX wrote:
  > > On Jul 24, 2013 1:00 AM, "Charles Campbell" <Charles.E...@nasa.gov> wrote:
  > >
  > > >
  > >
  > > > ping song wrote:
  > >
  > > >>
  > >
  > > >> any help?
  > >
  > > >>
  > >
  > > >>
  > >
  > > >>
  > >
  > > >> On Mon, Jul 22, 2013 at 9:03 AM, ping <songpi...@gmail.com <mailto:songpi...@gmail.com>> wrote:
  > >
  > > >>
  > >
  > > >>     this looks real nice!
  > >
  > > >>
  > >
  > > >>     http://vimdoc.sourceforge.net/htmldoc/
  > >
  > > >>
  > >
  > > >>     the thing that I like it , is that it looks exactly what it is in
  > >
  > > >>     vim , compacted pure text but still URL-able, like those code
  > >
  > > >>     cross reference pages generated by LXR
  > >
  > > >>     (http://lxr.linux.no/linux+v3.10.2/kernel/cpu/idle.c),  sth I
  > >
  > > >>     can't simply archieve in vimwiki.
  > >
  > > >>
  > >
  > > >>     what options of tools do we have (in vim or external) to generate
  > >
  > > >>     those beautiful pages?
  > >
  > > >>
  > >
  > > > I have no idea what was used for the online vim man pages.  You do know about TOhtml, though?
  > >
  > > At least one of the maintainers uses self-written python script; he wrote about this in the announce. Maybe there a link to the script in the announce, I do not remember.
  > >
  >
  > I think there is also a perl script distributed with Vim, in the runtime directory, called vim2html.pl. I'm not at all sure what it does.
  >
  > > TOhtml does not have support for links yet, though AFAIR it was promised. There is a plugin that adds them though.
  > >
  >
  > I don't know about "promised" but it would be a nice feature.
  >
  > How should it work? I haven't put any effort into such a thing because I'm not sure how it ought to work.
  >
  > I could just find any occurrence of each tag as found by the ctags interface and wrap it in a link, but to which file? TOhtml only gives you an unsaved buffer with a default file name, which the user could save anywhere with any name at all. I could just use href='./other_file.ext.html' but then the user must be sure all linked files are accessible from the same directory.
    >
  > How does formatvim handle this? Maybe consistency is the name of the game here. Or does anyone have thoughts on how they would LIKE it to work?
I link to the relative path and use perl script to postprocess. As I know for sure that angle brackets in text are escaped *always* and links format is the same all over the resulting text it is easy and safe to use regexes. Generally all this stuff is left to specification authors, but built-in HTML specification itself is not configurable. In-file links are converted to just #... as there is no need to specify file in this case. You can say whether you need links for all tags, none or just in-file ones.
Note that for help files I had to create start/end tag regex options in order to limit the number of cases when tag matches (these define regexes that would be wrapped into group with zero-width look-ahead/-behind modifier).
> --
  > --
  > You received this message from the "vim_use" maillist.
  > Do not top-post! Type your reply below the text you are replying to.
  > For more information, visit http://www.vim.org/maillist.php
  >
  > ---
  > You received this message because you are subscribed to the Google Groups "vim_use" group.
  > To unsubscribe from this group and stop receiving emails from it, send an email to vim_use+unsubscribe@googlegroups.com.
  > For more options, visit https://groups.google.com/groups/opt_out.
  >
  >
  
--
You received this message from the "vim_use" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups "vim_use" group.
To unsubscribe from this group and stop receiving emails from it, send an email to vim_use+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
 
No comments:
Post a Comment