blog-software-java/README.md
Minecon724 930a22d55a
docs: Add more to README
Signed-off-by: Minecon724 <git@m724.eu>
2025-02-10 16:26:08 +01:00

1.5 KiB

blog-software(config, template, content) = blog website

Usage

  1. Download the program from here
  2. Get a working directory. See [Project format](#Project format) below. Don't forget to git init!
  3. Run the program:
     java -jar blog-0.0.1-shaded.jar
    

Important caveats

Generated site must be the root of a subdomain, like https://example.com/.
You can't put it in a directory, like https://example.com/blog/

API

There's no "API," but it's possible to integrate this into your Java project.

See Main.java for an example.
If you need a Maven dependency, see here

Project format

There's an "Example workdir" which you can take inspiration from.

Basically:

  • assets/ - contains static assets
  • posts/ - contains posts
  • template/ - contains the template, see [Template format](#Template format) below
  • site-config.json - the site configuration
    • name: "my blog" property - site name
    • baseUrl: "https://example.com" property - URL of the site. It must be a root URL - folders are currently not supported. This is used only for the RSS feed.
    • custom properties

Template format

https://pebbletemplates.io is used

  • static/ - contains static assets
  • article_template.html - post template
  • index_template.html - index.html template