Wednesday, July 28, 2010

Re: Should 2html generate valid CSS by default?

Benjamin Fritz wrote:

> >> The :help says:
> >>
> >> > By default, HTML optimized for old browsers is generated. If you prefer using
> >> > cascading style sheets (CSS1) for the attributes (resulting in considerably
> >> > shorter and valid HTML 4 file), use:
> >> > :let g:html_use_css = 1
> >>
> >> At this point, I'd consider "old browsers" to be Internet Explorer 6
> >> and the like. I think the time has come to default g:html_use_css to
> >> true, by including this line in the tohtml.vim plugin file.
> >>
> >
> > The 7.3 release would be a good point to flip the default. Those who
> > use somethink like links to view the HTML will easily see that they need
> > to set an option. While most users don't have a hint that enabling CSS
> > will make the output much nicer.
> >
>
> So...I've had one person suggest using html_no_css (default off)
> instead of html_use_css (default on).
>
> I was intending to keep the current option and just turn it on by
> default, so that there were no surprises to people currently using the
> option, but I'm not sure whether this is really necessary.

You should not switch it on, as in assiging a value to the variable.
You can behave that CSS is used when the variable is not set, and when
the variable is set to non-zero non-empty.

> If I keep the existing option, and just turn it on in the plugin, a
> user could override it by:
>
> 1. using a "-c" command-line option
> 2. putting a VimEnter autocmd in the .vimrc
> 3. putting a file in the after/plugin directory
> 4. manually calling unlet g:html_use_css before generating the html
>
> But this is less convenient than just putting "let g:html_no_css" in
> the .vimrc.
>
> I would like to avoid that someone who has g:html_use_css in their
> .vimrc gets surprised when they unlet the variable and nothing
> happens. I'm leaning toward using both options, defaulting
> g:html_use_css to true, and overriding it if g:html_no_css is set. I
> could certainly be convinced to use just one or the other if there are
> good reasons to do so.

The documentation clearly says:

By default, HTML optimized for old browsers is generated. If you prefer using
cascading style sheets (CSS1) for the attributes (resulting in considerably
shorter and valid HTML 4 file), use: >
:let g:html_use_css = 1

We can change that to default to using CSS when the variable isn't set
and tell users to use this to disable that:

:let g:html_use_css = 0

Any problems with that?

--
Why I like vim:
> I like VIM because, when I ask a question in this newsgroup, I get a
> one-line answer. With xemacs, I get a 1Kb lisp script with bugs in it ;-)

/// Bram Moolenaar -- Bram@Moolenaar.net -- http://www.Moolenaar.net \\\
/// sponsor Vim, vote for features -- http://www.Vim.org/sponsor/ \\\
\\\ download, build and distribute -- http://www.A-A-P.org ///
\\\ help me help AIDS victims -- http://ICCF-Holland.org ///

--
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

No comments: