Releases: dauxio/daux.io
Releases · dauxio/daux.io
v0.15.1 - Bugfixes
- Fix #240 Quotation mark in heading truncates TOC
- Remove dependency to
myclabs/deep-copy
v0.15.0 Update dependencies
- Allow Guzzle 7 as a dependency (6 is still possible)
- Improve documentation by @saeedsajadi
- Use absolute class path for processors (#214) by @zucha
Bugfixes and theming improvements
- Allow to create a
style.css
file within the documentation for simple theme overrides #180 - Correctly check when no header image is specified #205
- Tweak styles to allow for inline images #204
- Allow anchors on links in Confluence #208
- Set dependencies to Symfony as both Symfony 4.4 and 5.0 #210
- Fix bugs where more than two identical titles would have the same link in the Table of Contents #209
Accessibility improvements and bugfixes
Highlights
- Search improvements
- Analytics improvements (Google Analytics and Plausible)
Search improvements
- Improve search form accessibility
- Allow search feature to work on static websites loaded from filesystem (and not a webserver) #198
Analytics changes
- Fix Google Analytics always being added to the page #194
- Use latest Google Analytics tracking code #202
- Add https://plausible.io analytics
Other changes
- Update to CommonMark 1.4, use embedded table extension
- Add
rel="noopener noreferrer"
on external links
So many bugfixes
Bugfixes
- Fix Search JavaScript to not conflict with the rest of the JavaScript ( #184 #190 )
- Fix fatal error while generating html files from markdown ( #185 #186 Thanks @proggeler )
- Fix PHP 7.4 Warnings ( #189 )
- Fix condition to add piwik analytics, would always be added
- Fix an edge case in Sort that makes pages disappear
Misc
- Compile JavaScript and CSS for defaults configuration of browserslist instead of the custom query we had
- Remove
--search
option in generate since it's enabled by default and the option doesn't allow to disable it. - Fix CSS compilation warnings
## Documentation
- Correct references to older versions of PHP
New configuration layer, minimum PHP 7.2, lots of bugfixes
Highlights
- Drop PHP 7.1 support, minimum is PHP 7.2 now
- Rewrite the configuration layer to be typed, fixes a lot of edge cases, now allows changin "serve" options through the command line and simplifies a lot of code paths #171
Bugfixes
- Fix relative links for images, now works correctly in serve and generate mode #169 #78
- Fix bug where files with non-ascii names would be blank, they are now transliterated #183
- Fix
Nesting level too deep - recursive dependency?
when multiple files have the same name #182
Internal
- Fix a type issue in an update #181
- Lazy load the CommonMark converter, only loaded when we actually need to generate a page, wins around 10ms
Small GitHub pages related fix
Rename the search library folder, as it started with _
and was ignored by GitHub Pages
Frontend Performance improvements
Highlights
- Smaller frontend payload
- Use a better library for the search engine, rewrote the UI with preact
- Dropped jQuery entirely
- Removed the inline code blocks feature, drastically reduced the CSS complexity.
- Changed the code highlight theme
- Upgrade highlight.js to 9.15.10
- Fix a small bug in the Vanilla JS side navigation
Performance improvements
The typical Daux page went from 333K to 96.7K. How did we do it ? Let's look at the details.
- Lazy load the
highlight.js
library (~158K) - Lazy load the search index (~30K in Daux's documentation)
- We removed jQuery entirely, replaced with vanilla JavaScript, even in search (~32K)
- Replaced the Twitter button/iframe with a built in solution, which has the added benefit of more privacy (~20K)
Added to that, we now do the highlight.js
rendering on the server side, so if you use fenced code blocks with the language specified in your documentation, we won't load highlight.js
at all.
Allow to override template with custom template name in attributes
You can now add template
in the markdown attributes to use an alternate template
Bugfixes in dropdown menu
- Fixes for the menu following the previous changes #127
Thanks to @JKingweb and @dustinwilson who contributed this fix