Home

Awesome

YASS: Yet Another Static Site (Generator)

As name says, it is static site generator written in Ada. It is headless application (no user interface). The program documentation is included in distribution.

Features

Downloading YASS

The easiest way to get YASS is by downloading the latest release for your operating system. For example, if you have windows, then download yass-windows_x86_64.zip.

Build from sources

Using alire

The easiest way to build YASS is via Alire. If don't have alire already, you can get it from the main website or auto-install it via Getada.dev.

To build and install it, simply run alr install yass and yass will automatically be added to alire's binary folder (default is $HOME/.alire/bin).

If you'd rather just download and build manually, navigate to a folder where you wish to build YASS and issue the following commands:

  1. alr get yass
  2. cd yass*
  3. alr update && alr build YASS will now be in the project's ./bin directory.

This should automatically pull all of the dependencies in, ie AWS and libcmark.

Using gprbuild

To build you need:

Navigate to the main directory(where this file is) to compile:

If you want to be able to print content of README.md file to terminal (by readme program command), copy file README.md to bin directory.

Note: If you want to move the program around, compile it in release mode. In debug mode the program may have problems with finding all dependencies.

Build unit tests

Note: Unit tests are currently being migrated to aunit and alire so this may not work as expected.

Navigate to tests/driver directory from the main directory (where this file is):

Or if you have Bob installed, type bob tests.

Running the program

Linux

To see all available options, type in console ./yass help in directory where binary file is. It works that same way for downloaded AppImage version of program. More information about using AppImage files you can find here:

https://docs.appimage.org/user-guide/run-appimages.html

If you want to run the program from other directory, you should set the environment variable YASSDIR to your current directory. Example: export YASSDIR=$(pwd). You don't need to set it manually when you use AppImage version of the program.

Windows

To see all available options, type in console yass.exe help in the directory where binary file is. If you want to run the program from other directory, you should set the environment variable YASSDIR to your current directory. Example: set YASSDIR="C:\yass"

Running unit tests

From the main directory (where this file is) go to test/driver directory and type in console ./test_runner. If you have Bob installed, you can type bob runtests.

Testing versions

Here are available testing versions of the program. You can find them in GitHub Actions. Just select option from the list of results to see Artifacts list. To use them, first you must download normal release. Then, for Linux: inside directory where the program is, type ./yass-x86_64.AppImage --appimage-extract to extract whole program to directory squashfs-root. And then move files from the archive to the proper location. To run that version, enter squashfs-root directory and type in console ./AppRun. For Windows: unzip files (replace existing) to the proper location where the program is installed.

Size is a file's size after unpacking. You will download it compressed with Zip.

Generating code documentation

To generate (or regenerate) code documentation, you need ROBODoc and Tcl scripting language. If you have them, in main program directory (where this file is) enter terminal command: others/generatedocs.tcl. For more information about this script, please look here. This version of script have set all default settings for the YASS code. If you have Bob installed, you can type bob docs.

Contributing to the project

For detailed information about contributing to the project (bugs reporting, ideas propositions, code conduct, etc), see CONTRIBUTING.md

Licenses

https://github.com/commonmark/cmark

TODO (someday or if someone wants to contribute)


As usual, I probably forgot about something important here :)

Bartek thindil Jasicki & A.J. Ianozi