bastion

module
v0.10.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 4, 2024 License: ISC

README

Bastion

Go Go Reference

Bastion is a simple webserver for serving articles written in markdown. These markdown articles are converted to html automatically as they are updated, and have a special header section to specify useful metadata about the article to Bastion.

Website layout

www.example.com/
    config.json
    content/
        about.md
        contact.md
    static/
        default.css

Developer Quickstart

First, make sure the following programs are installed:

  • go
  • pigz
  • pv
  • realpath
  • tar

Then run the following commands:

./build.sh build
./bastion www.example.com

For commandline options and usage information run bastion -h

Versioning

Since bastion is mostly used for my own personal website, it isn't going to be very stable. I plan on changing things around on a whim. With this said, as long as bastion has a major version of 0 (e.g. 0.1.12), minor versions will be treated as breaking changes, and patch versions will be treated as backward-compatible changes. Expect more for the former than the latter. If I one day decide to release bastion, then I will start using semver properly.

Directories

Path Synopsis
cmd
internal
errors
Package errors is a custom error package meant as a drop-in replacement for the standard errors package that allows for separation between client facing error messages and more detailed internal errors.
Package errors is a custom error package meant as a drop-in replacement for the standard errors package that allows for separation between client facing error messages and more detailed internal errors.
log

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL