LTS v3.1.0

This is a ~6mo mark since the last release of LTS v3.0.2—a couple of changes that you can find below, nothing major, except for includes and macros support added to darkness.

Changelog:

• Fixed version references for accurate installation
• Allowed gallery items to skip preview generation
• Added custom colors for generated previews
• Improved progress bars for image resizing
• Added indexnow.org support
• Enhanced build logs and directory creation
• Introduced dynamic Bing notifying (as a part of indexnow integration)
• Added LFS support with improved path handling (use LFS as a CDN)
• Updated logging options and default settings
• Added support for #+setupfile: and org-mode style macros with #+macro:

LTS v3.0.2

let's try this again

LTS v3.0.1

golang proxy requires the patch version

long term release of darkness
everything works as I expect to
no big changes or overhauls planned
of course use at your own risk
pretty proud of where we are now
my many salutations to you

Darkness LTS v3.0

long term release of darkness
everything works as I expect to
no big changes or overhauls planned
of course use at your own risk
pretty proud of where we are now
my many salutations to you

v2.1 with Komi 🍡

Changelog will say, but implemented pooling, performance updates, etc.

Changelog

• 2effa9c Add "..." after the end of description
• f405332 Add "Continue reading..." to rss descriptions
• c7d53d5 Add fancy quotes as corners for formatting regex
• deb1f73 Add math and exclude html head options.
• 825f708 Add more controls on whether to show name and email in website menu spans
• 31c9f69 Add the ability to set vendored and preview directories with toml
• cd744f3 Add tomb to the last found paragraph
• 3f64261 Added RSS generation
• 4756850 Added a draft accoutrement
• 612acc9 Added a flag to disable opening the browser by default when serving
• 93fd0b3 Added ability to add no-zoom class
• c88d194 Added ability to define custom prefixes for rss pages
• 02aa6a4 Added an option to make image clickable or non-clickable
• bc41046 Added holoscene processing
• 20c8707 Added multiple profiling options, like for clock, goroutines, and mutexes
• e3ebc1a Added separate progressbar for resizing images
• ebcb52e Added support for superscript and subscript markup
• ac7ba81 Added the ability to add page-specific extra head html elements
• 9b86dc7 Added the ability to provide custom darkness attributes
• ea287b9 Added the ability to provide per-page user #+options
• feceb90 Added the ability to vendor remote gallery images
• 976cf9a Breaking: rename extra_head to html_head
• e5a9c92 Bump golang.org/x/image from 0.1.0 to 0.5.0 (#2)
• ff02c6b Change orgmode's horizontal line to ----- from ---
• ad27c48 Clear line before posting build report to wipe progressbar away if vendor true
• b7cecf0 Create codeql.yml
• 48011a9 Default number of workers to logical CPU cores
• e028a91 Default to 4 workers
• 817fc13 Defer filling holoscene date in the orgmode parser
• d87815c Don't end spotify embeds with a horizontal divider
• 3a3507a Don't let Emilia join paths if it's already an http absolute link
• d52b9d0 Downloads now have a really cool progress bar!
• df09e48 Each description should be at least 14 characters in length
• 89d44ce Emilia does all the image stuff now
• 19d0fba Fixed a bug with galleries not being clickable
• a50c716 Fixed a typo in instant when showing vendor warning
• ed2b064 Fixed an issue, where files with no holoscenes got truncated
• b856c13 Fixed outdated spotify embeds
• d7f25b5 Fixed the graph in build.go
• 2c66913 Flatten the formatting in rss titles
• 7fcba84 Generate items' categories in rss
• 2614929 Get rid off the extra "/" in rss item's link
• 7966b76 Handle formatting, added en-dash and em-dash handling
• 6aed62e Implement komi pooling (#3)
• cabcdc1 Initialize accoutrement even if options are empty
• e42ea07 Initialize accoutrement right before filling them
• 19a55da Longer RSS descriptions, fixed pathing, added rss icon
• cc1a30c Misa gallery preview generation will always use readers (faster)
• 8589edf Move GalleryItemToImage to emilia from ichika
• 25693ee Omit empty optional rss elements.
• 5ecd253 Open the user's browser after serving
• 95f73cc Properly close the rss xml file after encoding
• 36f83ec Push hyperfine results
• 59db732 Recommend installing darkness through git clone and go install .
• 228a091 Remove hr from html exports
• d5fd396 Remove space from punct left/right as it's handled by [[:space:]]
• 7388bbc Removed source ishmael files, look at github.com/thecsw/ishmael instead
• 8aa5265 Reuse buildPagesSimple in rss and galleries
• f15663e Show some vendor warnings when building
• b2155f0 Simplify the text regex?
• 0718241 Small chore updates after the v2.0 release
• b9377a2 Support iframe html exports in responsive containers
• 70ff256 Try to use RFC 1123Z for rss instead
• 260f517 Update port number flag description for the serve subcommand
• 1c059fd Updated goreleaser settings
• 875a1a1 Updated spotify embed sizes
• feaeab6 Updated sum to support komi
• 41a7328 Updated the storage path for preview files.
• 4be18df Updated the subscript and superscript regex
• bc99eaf Updated the symmetric regexp matching
• d59b10f Updated to new komi
• 5941731 Updated to new komi
• 41ac914 Upgrade komi with safer child closures
• e3df5f0 Use a switch case when deciding bool accoutrements
• dd2f035 Use buffered writes when flushing output files
• 5b8e618 Use chi to serve local files
• 3d815bd Use komi's parent-most closure on kids waiting feature
• 966f103 Use optional buffered reads for parsers
• 929d803 Use some nicer capacity defaults when creating a page object
• 5c305c0 Users can now filter out ALL head directives instead of just extra ones
• d5e28a1 [ Continue reading... ]
• 80a7f1c gosec cleanupc
• 4d9d61f use rfc 1123 instead of 1123z
• 0409ce2 you are welcome :) (#1)

Darkness v2.0 is officially out! ❄️

I love Darkness 🥬

New updates that came out with v2.0 with huge performance improvements, new shiny features, new template, and more! Please read the excerpt below.

Thank you. ❤️‍🔥

Motivation

I have been writing and maintaining my website for more than five years! Asciidoctor was a nice way to bootstrap quick and good-looking web pages in a matter of minutes. However, my desire for quirky designs and math support, made the issue of bulding it annoyingly complicated. I just want a nice website that can do anything.

Darkness

It is my honor and pleasure to introduce you to Darkness. The most noble static website generator. To keep the long story short, check out my current website, which is dutifully built by Darkness.

She supports all org mode (and markdown!) formatting, native flex galleries (with automatic blurry previews generations and lazy loading!), full math support, social embeds (youtube, spotify, etc.), drop caps (they look fancy), automatic code highlighting, and much more 😈

Also, did I tell you it's super fast?

Performance

sandyuraz:source λ darkness build
Processed 128 files in 112 ms
farewell

Each page takes <1ms to process on my 2020 M1 MacBook Pro. With all the IO time included as well. Heavily optimized with gana workers, hunting heap moves, and heavy profiling.

You can play with best performance by tuning parallelization parameters with -workers N, and other flags you can use by calling darkness -help!

How to get it

It's simple! If you have go1.18 installed, you can install it through go tool with

go install -v github.com/thecsw/darkness@latest

Or you can also grab pre-built binaries from the releases page.

Building your Darkness website

Darkness and I provide you with a template website that you can get a copy of through the binary! Run the below, which will create a new directory, for example, here called ishmael,

darkness new ishmael

Go and run the website locally with darkness serve and explore Darkness in action!

Here is the web version of ishmael to browse around!

Okay, go, go! I'll see you later 😘

v1.3.0

Changelog

• 24706d6 Added a flag to add extra head content

v1.2.3

Changelog

• 501ca68 Fixed details bug

Support for HTML details and automatic syntax highlighting!

In this update, you can use

#+begin_details summary
<any content>
#+end_details

or even without summary (will be defaulted to open for details) will create an html details section!

Also, automatic syntax highlighting with hight

New flags in darkness.toml to toggle and switch between themes

Changelog

• 4996ac2 Added a new details config + using bit flags
• e29083f Added benchmark tests
• 22065aa Added syntax highlighting
• 7022af4 Better detect math with environment "\begin"
• fe9171c Explicit toml tags
• 159cd91 Full details support added!
• 7a133ff Improved math detection
• 57ea45c Removed Parser, which was not implemented
• 74e5aa8 Removed unused MetaTags and Links from Page

v1.2.1 is out! 🚀🤷‍♀️

Changelog

• c2fc35d Added a new flag to disable parallel builds
• 019d87e Added custom dates and #+date: option to orgmode
• 9a26e41 Bumped github.com/BurntSushi/toml to v1.1.0
• b79b45b Fixed the caption parsing and using constants now
• 942ac48 Improved meta tag containers allocation
• aaa5314 Improved orgmode option selects when parsing
• 15d169d Started using goreleaser for releasing binaries
• f3bdaff Tighter regex on formatting and enable double pass regex