Version 0.3.0-prerelease.3

Release Notes

Features

• Workspace Support - shadows-withal/pr532, jamesmunns/i493

  You can now tell oranda to build multiple sites at once! By default, this will also generate a separate "root"
  page, providing an index into all projects defined within your workspace.

  Details TBD

Fixes

• Display platforms alphabetically in install widget - Plecra/pr544, shadows-withal/i480

  Platforms are now sorted alphabetically in the install widget dropdown. This is an improvement over the
  previous unsorted state.

• Show prerelease contents on changelog pages - shadows-withal/[pr549]

  This is a simple bug fix. Previously, we accidentally hid the body of a prerelease on its own separate changelog page
  (but mysteriously, it showed up on the main changelog page when prereleases were toggled!)

Install oranda 0.3.0-prerelease.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.3.0-prerelease.3/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.3.0-prerelease.3/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.3.0-prerelease.3

Download oranda 0.3.0-prerelease.3

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

Version 0.3.0-prerelease.2

Release Notes

Features

• Workspace Support - shadows-withal/pr532, jamesmunns/i493

  You can now tell oranda to build multiple sites at once! By default, this will also generate a separate "root"
  page, providing an index into all projects defined within your workspace.

  Details TBD

Fixes

• Display platforms alphabetically in install widget - Plecra/pr544, shadows-withal/i480

  Platforms are now sorted alphabetically in the install widget dropdown. This is an improvement over the
  previous unsorted state.

Install oranda 0.3.0-prerelease.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.3.0-prerelease.2/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.3.0-prerelease.2/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.3.0-prerelease.2

Download oranda 0.3.0-prerelease.2

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

Version 0.3.0-prerelease.1

Release Notes

Features

• Workspace Support - shadows-withal/pr532, jamesmunns/i493

  You can now tell oranda to build multiple sites at once! By default, this will also generate a separate "root"
  page, providing an index into all projects defined within your workspace.

  Details TBD

Install oranda 0.3.0-prerelease.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.3.0-prerelease.1/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.3.0-prerelease.1/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.3.0-prerelease.1

Download oranda 0.3.0-prerelease.1

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

0.2.0 - 2023-07-19

Release Notes

BREAKING

• make artifact autodetect configurable - Gankra/pr527

  We now provide a new boolean key, components.artifacts.auto, that lets you explicitly
  enable autodetection of artifacts. Previously, we would only enable this if you either
  turned on components.artifacts.cargo_dist, or if you provided some package manager entries.
  Since oranda does also support gleaning artifacts even without cargo-dist support enabled,
  we added this extra switch to let you toggle it without having to mess around with package managers.

  This is a breaking change, as enabling cargo-dist support or specifying package managers does
  not turn on auto-detection of artifacts anymore. If you were previously relying on auto-detection, your
  artifacts will no longer be displayed. To re-enable auto-detection, create a oranda.json file if you don't
  already have one, and set the following configuration:

  {
    "components": {
      "artifacts": {
        "auto": true
      }
    }
  }

Features

• Typescript syntax highlighting support - shadows-withal/pr525, geelen/i513

  You can now use the ts/typescript languages in code blocks! Hooray for types!

• Better logo positioning - SaraVieira/pr524, tertsdiepraam/i519

  Logos set via the styles.logo option will now be properly centered/aligned in all themes,
  and set to a maximum width so that a 1920x1080 logo won't be displayed in its full width and height, thus
  pushing all content down below the fold.

Fixes

• Hacker theme highlight color - SaraVieira, pr523/i522

  Selecting text in the Hacker theme now applies a nice, green, high contrast highlight background
  color, instead of being the same color as the text, therefore hiding the content.

• Package managers documentation - shadows-withal/pr521, tertsdiepraam/i520

  Some minor fixes to bring the package manager docs up to speed with how oranda actually processes options.

Maintenance

• Refactor into using minijinja templates instead of axohtml - shadows-withal/pr526

  A biiig internal refactor moving us away from our previous typed-HTML-in-Rust approach of generating
  HTML, towards using a proper template language (Jinja2) instead. This allows for a lot more flexibility
  and separation of concerns going forward!

Install oranda 0.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.2.0/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.2.0/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.2.0

Download oranda 0.2.0

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

Version 0.2.0-prerelease.1

Release Notes

BREAKING

• make artifact autodetect configurable - Gankra/pr527

Features

• Typescript syntax highlighting support - shadows-withal/pr525, geelen/i513

• Better logo positioning - SaraVieira/pr524, tertsdiepraam/i519

Fixes

• Hacker theme highlight color - SaraVieira, pr523/i522

• Package managers documentation - shadows-withal/pr521, tertsdiepraam/i520

Maintenance

• Refactor into using minijinja templates instead of axohtml - shadows-withal/pr526

Install oranda 0.2.0-prerelease.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.2.0-prerelease.1/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.2.0-prerelease.1/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.2.0-prerelease.1

Download oranda 0.2.0-prerelease.1

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

0.1.1 - 2023-07-04

Release Notes

Fixes

• Remove OpenSSL dependency - ashleygwilliams/pr515, geelen/i514

  If a release happens without an OpenSSL issue, does it really happen? In trying
  to run oranda build on a beta image for Cloudflare Pages, an end user discovered
  that we hadn't fully vanquished our dependency on OpenSSL. With this PR, we've
  made 100% sure we have.

• Allow schema key in oranda.json - Gankra, pr506

  To improve the user experience of configuring oranda, we error on unexpected
  keys in the oranda.json file- which will help people see typos and other
  mistakes. However, this checking was over-eagerly erroring when folks added
  a schema key so they could use VS Code's schema support. This PR makes an
  exception for users including the "non-functional" (in oranda) schema key.

• Add fallback to macOS Intel artifacts if Apple Silicon detected, but no artifacts found - Gankra, pr511

  Platform support and detection is slightly more complicated on Apple/macOS
  machines because Apple offers Rosetta2 which allows you to run binaries built
  for older Intel-based systems on the new Apple Silicon ones (but not vice versa).
  This PR updates the install widget's behavior to show artifacts built for
  Apple Intel-based systems if it detects an Apple Silicon system but cannot find
  any binaries built for Apple Silicon.

• Artifact table width on mobile - SaraVieira, pr505

  On mobile, the artifact table's width was forcing a scroll. We've updated the
  CSS to fix this!

Install oranda 0.1.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.1.1/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.1.1/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.1.1

Download oranda 0.1.1

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

0.1.0 - 2023-07-03

Release Notes

What is oranda?

oranda is a hands-off static site generator for people who want a website for their tool but don't want to get knee-deep into web development. As long as you have a README.md in your directory, you can benefit from oranda. oranda will also try to automatically work with:

• Release artifacts (currently only for GitHub releases)
  • cargo-dist-generated ones, and
  • arbitrary release artifacts
• mdbookdocs
• GitHub-supported project/maintainer funding sources

oranda is designed to just work in a lot of cases, and in cases where it doesn't, it should provide fine-grained configuration so you can make it work for your use case.

Features

Components

Github release artifacts inference

We can now not only figure out whether you're using cargo-dist automatically, but we also try and support arbitrary tarballs, as long as they're attached to a release and they're following the target-triple format. Oranda will now, for example, pick up a release artifact called myapp-aarch64-apple-darwin.tar.xz, even if the project isn't using cargo-dist to publish releases.

Smarter install widget

The installer widget on our main page has been upgraded! It now not only shows a select box where you can switch between different architectures (though we still attempt to figure out what platform you're running on), but it now additionally displays your package managers, all in a sleek tab-style view:

You can customize which package managers you want to be displayed on in this widget vs. which ones should only be displayed on the separate install page, as well. Read more in the docs

Funding page

oranda now has the ability to autodetect whether you're using GitHub's funding embed functionality (meaning you have a .github/FUNDING.yml), in which case it'll automatically generate a page showing your available funding options.

Additionally, you can enhance this page by selecting a particular funding channel to be prioritized as your "main" funding method. You can also provide custom content from a funding.md Markdown file, to provide additional context to your funding page. Read more in the docs

This is less of a defined feature and more of an experiment on how we can better integrate maintainers' funding sources onto their websites. Please let us know what you think, or if you have any other feedback or input!

mdbook autodetect and styling

oranda themes now get applied to your mdbook output, too, meaning there's less of a discrepancy between your flashy oranda page and your default-mdbook-styled docs. We've also been hard at work being able to detect when you use mdbook without you having to set it, which should now work in the majority of cases.

Configuration

New configuration structure

We've completely revamped our configuration structure to be more future-proof and to require less refactoring in the fullness of time. For the new configuration layout, please consult the docs.

One other major change is that we now reject unknown config keys. This means that if you've had a oranda 0.0.3 site, it will now force you to migrate your config to the new format. We've decided on this because we believe that doing anything but hard erroring in this situation would lead to unwanted behavior (old keys getting interpreted in new, weird ways, and so on).

Config schema

oranda's configuration schema is now available in a JSON schema for each release starting with this one. This means that in editors like VSCode, you can attach the schema to your oranda.json file and get autofill and documentation, like this:

{
  "$schema": "https://github.com/axodotdev/oranda/releases/download/v0.1.0/oranda-config-schema.json"
}

CLI

dev command

This release introduces oranda dev, which bundles both building your site and serving it from a file server, as well as sprinkling in auto-recompilation when files change. It's intended to be the prime command for local development of a oranda site.

Bug fixes

(this is a selection, there's been way too many to fully list, at least until we're able to automatically generate a list)

• Various style fixes, lists now display correct, colors should be less offensive to the eye, that sort of stuff
• We're much better now at handling complex release histories!
• We've completely removed the version key from the configuration. It wasn't used, and we probably won't use it in the future, either

Docs

Documentation has had a major rewrite! We now provide a full configuration overview, as well as more detailed writeups for major parts of functionality.

Thank you to our contributors!

Despite being formally unannounced, several intrepid folks discovered oranda, and have been using it for personal projects and contributing issues and PRs. Their feedback has been invaluable in getting oranda to 0.1.0 today and we'd like to thank them:

• 2mill
• andrewmd5
• jamesmunns
• MarcoIeni
• msjarvis
• pomdtr
• proofconstruction
• tshepang
• untitaker
• zkat

Install oranda 0.1.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.1.0/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.1.0/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.1.0

Download oranda 0.1.0

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

Version 0.1.0-prerelease.9

Release Notes

FIXME: write a proper changelog for the next release

• various fixes
• much faster
• mdbook integration change

Install oranda 0.1.0-prerelease.9

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.1.0-prerelease.9/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.1.0-prerelease.9/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.1.0-prerelease.9

Download oranda 0.1.0-prerelease.9

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

Version 0.1.0-prerelease.8

Release Notes

FIXME: write a proper changelog for the next release

• various fixes
• much faster
• mdbook integration change

Install oranda 0.1.0-prerelease.8

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.1.0-prerelease.8/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.1.0-prerelease.8/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.1.0-prerelease.8

Download oranda 0.1.0-prerelease.8

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum

Version 0.1.0-prerelease.7

Release Notes

FIXME: write a proper changelog for the next release

• various fixes
• much faster
• mdbook integration change

Install oranda 0.1.0-prerelease.7

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/axodotdev/oranda/releases/download/v0.1.0-prerelease.7/oranda-installer.sh | sh

Install prebuilt binaries via powershell script

irm https://github.com/axodotdev/oranda/releases/download/v0.1.0-prerelease.7/oranda-installer.ps1 | iex

Install prebuilt binaries into your npm project

npm install @axodotdev/oranda@0.1.0-prerelease.7

Download oranda 0.1.0-prerelease.7

oranda-aarch64-apple-darwin.tar.gz	checksum
oranda-x86_64-apple-darwin.tar.gz	checksum
oranda-x86_64-pc-windows-msvc.tar.gz	checksum
oranda-x86_64-unknown-linux-gnu.tar.gz	checksum