Unclaimed project
Are you a maintainer of quarkdown? Claim this project to take control of your public changelog and roadmap.
Changelog
🪐 Markdown with superpowers: from ideas to papers, presentations, websites, books, and knowledge bases.
Last updated 1 day ago
🎄 This release focuses on Quarkdown as a reliable static site generator. The HTML output is now ready to be deployed straight out of the compiler, with enhanced SEO, polished responsiveness, and better support for multi-page (subdocuments) projects.
Check out iamgio.eu, my new personal website, for an example of a website fully powered by Quarkdown, with even a blog!
The sources are available here, and its deployment on GitHub Pages uses the brand-new .
Quarkdown now takes better care of HTML metadata for an improved SEO, to let your websites rank higher in search engines.
Additionally, new metadata functions are introduced: .docdescription and .dockeywords.
.docname {Quarkdown}
.docdescription {A Markdown-based typesetting system}
.dockeywords
- markdown
- typesetting
- papers
plain documentsPlain documents are now more beautifully responsive than ever, for portable websites.
When used in paged and slides documents, the .pagemargin function now takes effect only from the page where it's declared onward. This allows for different page margin settings in different parts of the document.
If you used to call the function at the start of the document to set global margins, this behavior is unchanged.
.pagemargin {topcenter}
On all pages
# First page
# Second page
.pagemargin {topleft}
From second page
# Third page
Thanks @sanoakr!
The new .resetpagenumber {from?} function allows overwriting the current page number at any point in a paged or slides document.
These changes are reflected in .currentpage and page numbers in the table of contents.
.pagemargin {topcenter}
.currentpage
# First page
# Second page
.resetpagenumber from:{20}
# Third page
Thanks @sanoakr!
Along with paged documents, table of contents in slides documents now also shows page numbers for each entry.
The new .listfiles function returns a collection of the files in a directory on the file system. It's unordered by default, or can be sorted by name or date.
The output can be iterated upon, or supplied to other functions. For example, it's possible to perform automatic bulk inclusions:
.includeall {.listfiles {somedirectory} sortby:{name}}
A new .subdocument {path} {label?} function has been added as a more flexible alternative to the [Label](path.qd) syntax to register subdocuments to the knowledge graph and link to them.
As opposed to the static link syntax, the function accepts dynamic paths. Thus, it's possible to use .listfiles to automatically link all documents in a directory.
Great for blogs!
.foreach {.listfiles {somedirectory}}
path:
.path::subdocument label:{.path::filename extension:{no}}
The example also shows the new .filename {path} function, which allows retrieving a file name from its path.
The main difference between inclusion and subdocuments is how the included document is sandboxed:
by default, .include lets all changes propagate to the parent document, while subdocuments isolate them.
Now, .include accepts an optional sandbox parameter to control this behavior. In ascending order of isolation:
share (default): all changes propagate to the parent document.scope: like share, but function and variable declarations do not propagate.subdocument: changes, including metadata and layout options, do not propagate.
mode:{markdown} can now be used in .csv to parse cell content as inline Quarkdown source code. This allows for formatting, rich content, and even function calls inside CSV.
String sorting operations performed in the stdlib now prefer alphanumeric comparisons. This applies to .tablesort and .listfiles.
abc120 < abc30abc120 > abc30This is more natural and correct. .tablesort can now be used for real-world leaderboards!
Up to now, a dash (-) surrounded by spaces was replaced by an em-dash (—). Now, it produces an en-dash (–) instead.
To get an em-dash, use two dashes (--), not necessarily surrounded by spaces.
Decorative headings (#! Title) are now ignored in the navigation sidebar.
When importing a subdocument, modifications to document metadata, layout, or other properties no longer propagate to the parent document.
This allows, for instance, to call .docname in a subdocument to set its own title, which will be shown in the browser tab when viewing that subdocument.
Unset properties will still fall back to the parent document's values.
.includeWhen including documents from different directories via .include, the working directory is now updated accordingly. This allows relative paths to work as expected inside included documents.
Consider the tree:
main.qd
dir/
| other.qd
| image.png
From main.qd:
.include {dir/other.qd}
Previously, in order to access image.png from other.qd:
Now, with the updated working directory:
When exporting multi-document projects as HTML:
example.com/subdoc rather than example.com/subdoc.html).media subdirectory), rather than having a shared one for all subdocuments.
.listfiles by @iamgio in https://github.com/iamgio/quarkdown/pull/260.subdocument by @iamgio in https://github.com/iamgio/quarkdown/pull/261.include change the working directory by @iamgio in https://github.com/iamgio/quarkdown/pull/266sandbox parameter to .include by @iamgio in https://github.com/iamgio/quarkdown/pull/283Full Changelog: https://github.com/iamgio/quarkdown/compare/v1.12.1...v1.13.0
Shout out to our sponsors! 🎉
@vitto4
