dauxio / daux.io

Daux.io is an documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly. It helps you create great looking documentation in a developer friendly way.
https://daux.io/
MIT License
791 stars 195 forks source link

Heading (h1) tags not generating correctly #278

Closed MatthewJamesHanson closed 1 year ago

MatthewJamesHanson commented 2 years ago

I'm not sure what caused this. We've been using daux without this issue. Now the < h# > tags are not being generated correctly on the site on any page anywhere.

In each case, the symptoms are like this: image

while the markdown is like this: image

and the html is like this; image

Thanks for any help

-- Edit

I can put this into the markdown and it works as expected

<h2> some heading</h2>

For any one else, if you are having this problem. This is a nice solution (until the issue is fixed). This allows for the table of contents to still be created (whereas if you just use the manual <h#> tags, the table of contents is not generated with content. image

onigoetz commented 2 years ago

Hello, sorry for the delay.

I can't reproduce your issue just out of the box so I'd need to have a bit more information on your setup

MatthewJamesHanson commented 2 years ago

what version of Daux are you using ? daux/daux.io 0.16.2

are you using it through a Docker image or installed through Composer ? Installed through composer.

if composer, is it in a project with other dependencies (like commonmark) Never heard of commonmark. No dependencies that I'm aware of. We just use a directory of markdown files -- so our setup is basic.

are you using any Processor ? I didn't configure any specifically, so only any that are in use by default.

MatthewJamesHanson commented 2 years ago

I resolved this manually. The underlying issue is still odd and not resolved, but for others (if any) here is what I did: Upgraded PHP to 8.1.4, then had to resolve this bug (https://github.com/barryvdh/laravel-dompdf/issues/757) manually, by changing line 79 in C:\Users\<me>\AppData\Roaming\Composer\vendor\daux\daux.io\libs\Tree\Directory.php $buckets['numeric'][abs(($exploded[0])][$key] = $entry; to this line $buckets['numeric'][abs((int)$exploded[0])][$key] = $entry;

ciao!

onigoetz commented 1 year ago

Thanks for the feedback, I added the proposed fix

onigoetz commented 1 year ago

This change has been released in 0.20.1