Explicit H1 heading

[Randy Selzler <RSelzler@…>]

Currently the H1 heading is forced to the page name.
This is a reasonable default, but explicit control would be useful.

Perhaps it could be implemented, without breaking existing pages,
as follows.

• Render the page name in roughly the same position, but with a custom style that defaults to a small font. Page names can get rather long, especially with "docs tree" support which includes the path. The name is important and I like it rendered near the top, but not so large.
• If the page markup begins with '= My Explicit Title', then render it as an H1 heading. If not, then render an H1 heading using the page name (converting '_' to blank?), much like it does now.

[sheep]

You could display the path to the actual page enclosed in a span with special class, handled with css. You could even make the parts of that path into links, like MoinMoin does. Of course that's not currently Hatta's problem, but I can see that it might be worth working on in your branch. -- Radomir Dopieralski

---

Interesting idea.

Question: can I mix html tags with Wiki markup?
What are the rules?
Should I just experiment?
-- Randy

---

All html tags are escaped, so that <div> appears as <div>. Internally, Hatta only parses the content of the page and only once -- so you can only use html tags after that. -- Radomir Dopieralski

---

I'm confused by "you can only use html tags after that"...
I've experimented a little, but I don't see any way to
pass html from the plain text markup to the browser.
-- Randy

---

I've decoupled the page name from the H1 heading in my engine.

It still automatically adds the page name at the top,
but the engine uses h4 instead of h1. This keeps the
display self documenting, but less intrusive.

I've added = My Foo Page Heading at the beginning
of my page markup, to provide an explicit H1 (instead of
using the page name). This allows me to avoid blanks
and other special characters in page names and links.
The H1 heading can have any characters and can evolve
independent of the page name.
-- Randy

---

You really don't need to change the HTML to make the heading less obtrusive. You can just change the CSS. No change in code required. -- Radomir Dopieralski

[sheep]

I think this is not really something needed by everyday wiki user, so I'm going to close it as "wontfix". Anybody willing to work on this is free to reopen it.