An open API service indexing awesome lists of open source software.

https://github.com/dense-analysis/denseanalysis-org

The denseanalysis website
https://github.com/dense-analysis/denseanalysis-org

Last synced: 5 months ago
JSON representation

The denseanalysis website

Awesome Lists containing this project

README

          

# denseanalysis.org

The Dense Analysis website built with [Hugo](https://gohugo.io/) to generate the
entire site as static content. The site is served as static content to keep
maintenance costs low, to improve performance, and to increase security.

This project uses an AGPL license to ensure that it will always be available for
those who need it.

## Development

Use Docker to run the site with [Hugo](https://gohugo.io/installation/).
[Docker Desktop](https://www.docker.com/products/docker-desktop/) is the easiest
to use on all platforms. Make sure you have pulled submodules for templates.

```
git submodule update --init
docker compose up
```

The site will immediately start and you can view it at http://localhost:1313

You can validate pages via the `./validate-path.sh` script by passing in a path
to a page or a file path in the `content/` directory.

The site will be built into the `public` directory, which can be served via
nginx or Apache. See the rest of the
[Hugo documentation](https://gohugo.io/documentation/)
for knowledge on how to build sites with Hugo.

You can validate pages via the `./validate-path.sh` script by passing in a path
to a page or a file path in the `content/` directory. Files will be pulled in
from the `public` directory for validation.

## Deployment

Just run `./deploy.sh` on a server, which is what GitHub actions will execute on
the Dense Analysis host. This just runs `docker compose run site 'hugo'` after
pulling the latest code to build the files with the same Hugo Docker image used
for local development.