Žiadny popis

1 Vetvy

Honza Pokorny 24b4831268 Use GOMODCACHE, not GOPATH when building statik		4 rokov pred
cmd	f82c45db04 Hello world!	4 rokov pred
include	d2e5bba410 Add links to parents in tree	4 rokov pred
pkg	636a57e095 Remove autogenerated statik module	4 rokov pred
.gitignore	636a57e095 Remove autogenerated statik module	4 rokov pred
Dockerfile	06feb07cfb Use Makefile in Dockerfile	4 rokov pred
LICENSE	f82c45db04 Hello world!	4 rokov pred
Makefile	224d6814d2 Use GOMODCACHE, not GOPATH when building statik	4 rokov pred
README.md	5f54845356 Add contribution guidelines	4 rokov pred
go.mod	f82c45db04 Hello world!	4 rokov pred
go.sum	f82c45db04 Hello world!	4 rokov pred
main.go	f82c45db04 Hello world!	4 rokov pred

Smithy

smithy (n) A blacksmith's shop; a forge.

Smithy is a web frontend for git repositories. It's implemented entirely in Golang, compiles to a single binary, and it's fast and easy to deploy. Smithy is an alternative to cgit or gitweb, and doesn't seek to compete with Gitea and the like.

Golang
Single binary
Easy to deploy
Fast
Customizable
Free software
Javascript-free

Building

The only dependency is Golang.

$ git clone https://github.com/honza/smithy
$ make
$ ./smithy --help

Installing

$ smithy generate > config.yaml
$ smithy serve --config smithy.yaml

Configuration

title: Smithy, a lightweight git forge
description: Publish your git repositories with ease
port: 3456
git:
  root: "/var/www/git"
  repos:
    - path: "some-cool-project"
      slug: "some-cool-project"
      title: "Some Cool Project"
      description: "Something really cool to change the world"
    - path: "ugly-hacks"
      exclude: true

static:
  root:
  prefix: /static/

templates:
  dir:

Customizing templates and css

Out of the box, smithy bundles templates and css in the binary. Setting static.root, and templates.dir to empty string will cause smithy to use the bundled assets.

If you'd like to customize the templates or the css, copy the include directory somewhere, and then set static.root, and templates.dir to that directory.

Demo

Smithy is currently hosting itself on my domain.

Contributing

Contributions are most welcome. You can open a pull request on GitHub, or email a patch to me@honza.ca.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

README.md