pilcrowonpaper / malta Goto Github PK

In order to navigate easily on a site made with Malta, a configurable breadcrumb can be very useful. A plus for the UX too.

That's it, thanks a lot for this project 🙏

Hello ! I think it would be nice to have navigation in the shape of a tree view, in order to simplify navigation through the pages and subpages. Wiki and SSG tools like Obsidian, Quartz or VitePress are doing it well, here is some examples.

Have a nice day 🙏

Currently, /<folder-name>/index.md page (/<folder-name>/) is supported thanks to the generation of the final HTML file. I think what's missing is the possibility of accessing this page other than by going directly to its URL. In the sidebar, pages at the root of a subfolder are not available in the sidebar.

That's it, thanks a lot for this project 🙏

Kindly provide a dark mode option. Everything is just to bright and some of the text isn't as visible

The ability to link to a specific heading or subheading would be a great addition to this awesome CLI (thx pilcrow)!

Image is overflowing the width of the page

Suggested fix:

img {
    max-width: 100%;
    height: auto;
    object-fit: cover;
}

After:

List elements that are bolded have a new line

Suggested fix: remove the line below

After:

As i want to put my docs into the root directory of my project, it isnt very intuitive or clear, what a directory named "pages" is for. Therefor i would appreciate if there was a property in the config file to control the folder name. Maybe i'll implement it myself.

It's currently black or blue (???) when it should be dark gray

I recently went through the Lucia Auth documentation and found it challenging to follow the tutorials due to the lack of proper code syntax highlighting. Improving this would significantly enhance readability and usability of the documentation.

Currently the code segments in the tutorials are not highlighted as effectively as they are when viewed directly on GitHub. This diminishes the readability and makes it harder to follow the code logic and structure.

Screenshot comparison

comparisons of sveltekit github-oauth tutorial on docs and github

Improving this aspect of the documentation would aid developers in better understanding and utilizing the tutorials provided by Lucia Auth.