startgit

Static page generator for git repositories

git clone git://git.dimitrijedobrota.com/startgit.git

commit	844198252fc483804d2efa8885170b3800eb1df4
parent	437dae3963a85db26af16a5fdba1e685f4787193
author	Dimitrije Dobrota <mail@dimitrijedobrota.com>
date	Sun, 26 Jan 2025 20:56:36 +0100

Add README.md

Diffstat:

M	CMakeLists.txt	\|	+-
M	README.md	\|	++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++----------
M	source/main.cpp	\|	+-

3 files changed, 62 insertions(+), 12 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt

@@ -4,7 +4,7 @@ include(cmake/prelude.cmake)

project(

startgit

VERSION 0.1.34

VERSION 0.1.35

DESCRIPTION "Static page generator for git repositories"

HOMEPAGE_URL "https://git.dimitrijedobrota.com/stargit.git"

LANGUAGES CXX

diff --git a/README.md b/README.md

@@ -1,19 +1,69 @@

# startgit

This is the startgit project.

Static page generator for git repositories

# Building and installing

## Description

See the [BUILDING](BUILDING.md) document.

With this project you can seamlessly turn a git repositories into a static

webpage, with auto generated indexes, diffs, commits and files for for each

branch.

# Contributing

The big source of inspiration for this project is [`Stagit`](https://codemadness.org/git/stagit/log.html). I've copied

most, if not all, of the functionality, with a few twists to fit my needs

better and fit with the reset of the aesthetic.

It's configured to make pages for my [`peronal projects`](https://git.dimitrijedobrota.com/),

but as generation code is self documenting , it can be easily adopted to fit

your needs.

As of now, md4c library is used to render markdown files in html for specific

pages in order to improve readability, until I find time to develop

sophisticated Markdown to HTML converter.

## Dependencies

* CMake 3.14 or latter

* Compiler with C++20 support (tested: clang 18.1.8, gcc 14.2.1)

* [`Git2Wrap 0.1.0`](https://github.com/DimitrijeDobrota/gitwrap)

* [`Poafloc 1.0.0`](https://github.com/DimitrijeDobrota/poafloc)

* [`Hemplate 0,2,2`](https://github.com/DimitrijeDobrota/hemplate)

* [`md4c`](https://github.com/mity/md4c)

## Building and installing

See the [`BUILDING`](BUILDING.md) document.

## Usage

> Run `stargti --help` for the explanation of command line arguments

## Version History

- 0.2

* Files, commits and diffs for each branch

* RSS and Atom feeds per branch

* On demand evaluation

* Github to local link translation

- 0.1

* Initial development phase

## Contributing

See the [`CONTRIBUTING`](CONTRIBUTING.md) document.

See the [CONTRIBUTING](CONTRIBUTING.md) document.

# Licensing

<!--

Please go to https://choosealicense.com/licenses/ and choose a license that

fits your needs. The recommended license for a project of this type is the

GNU AGPLv3.

-->

This project is licensed under the MIT License

- see the [`LICENSE`](LICENSE.md) document for details

## Acknowledgments

Inspiration, code snippets, etc.

* [`Stagit`](https://codemadness.org/git/stagit/log.html)

diff --git a/source/main.cpp b/source/main.cpp

@@ -797,7 +797,7 @@ static const poafloc::option_t options[] = {

static const poafloc::arg_t arg {

options,

parse_opt,

"config_file",

"repositories...",

"",

};

// NOLINTEND