Re: [ELPA/elpa-admin] Render README.org as HTML with ox-html

[Adam Porter]

Stefan Kangas <stefankangas@gmail.com> writes:

> Stefan Monnier <monnier@iro.umontreal.ca> writes:
>
>> One thing I noticed in the resulting <pkg>.html file is that the doc is
>> not clearly delimited any more (e.g. it tends to use <h2> headers for
>> its own top-level entities whereas the surrounding HTML uses <h2> as
>> the header that introduces the doc).
>
> This should be rather easy to fix with CSS.  You wrap it in some div
> using a particular class (IIRC it already is wrapped) and then you use
> CSS selectors based on that to set the font sizes to something more
> suitable.

This should be fixable in the export settings, i.e. see:

  (defcustom org-html-toplevel-hlevel 2
    "The <H> level for level 1 headings in HTML export.
  This is also important for the classes that will be wrapped around headlines
  and outline structure.  If this variable is 1, the top-level headlines will
  be <h1>, and the corresponding classes will be outline-1, section-number-1,
  and outline-text-1.  If this is 2, all of these will get a 2 instead.
  The default for this variable is 2, because we use <h1> for formatting the
  document title."
    :group 'org-export-html
    :type 'integer)