Project:Texy!
Version:6.x-1.x-dev
Component:Documentation
Category:task
Priority:normal
Assigned:Unassigned
Status:active

Issue Summary

While playing with Texy I came across something that I don't know if it is an undocumented feature or a bug but it works quite nicely.

If your template is using H1 and H2 for major headers you would (or should) configure Texy to use headers starting at H3.

So, according to the documentation

===Major Header===

##Minor Header

Would produce

<h3>Major Header</h3>
<h4>Minor Header</h4>

That's fine for people who only need two content headers but I find that extremely limited since it has no provision for H5 and H6.

So, I tried adding more '###s' to see what happened.

It took a few minutes to figure out what was happening but what I found seems to be consistent

Here's the algorythm:

- all headers begin with at least 2 '##' characters but up to 5 (or even more but beyond that it doesn't count)
- the header with the most '#'s becomes the first header (H3 if set as described above)
- from that point, removing 1 '#' makes it the next header.

so

#####This is an H3
####This is an H4
###This is an H5
##This is an H6

But

####This is an H3
###This is an H4
##This is an H5

If you make your first header only 4 #'s, you are limited to H5

But... the cool thing is, that

#####This is an H3
##This is an H6

You don't need one of each header between... just remember the most #'s becomes the H3

Note: This is page specific and so if you use ## for H3 on some pages and ##### on others it might be a styling problem.
But it shouldn't be because on pages where you only need H3 and H4 you can use ### for H3 and ## for H4
Then on pages where you need H5, you use #### for H3, ### for H4, and ## for H5

The syntax changes depending on how many headers you need but it seems to be consistent.

- Kent

nobody click here