perses / website

Perses website for documentation and demo
Apache License 2.0
1 stars 3 forks source link

Instructions for running Hugo locally #31

Open agardnerIT opened 4 weeks ago

agardnerIT commented 4 weeks ago

I'd like to start contributing to perses and part of the way I do this with projects is to learn and document as I go.

I often submit docs PRs to help others along the way.

I've cloned this repo but having trouble running the doc stack locally.

I get a blank page on 1313.

I've tried various combinations of the hugo command in docker-compose.yaml but no dice.

I've also tried:

cd website/website
git submodule add https://github.com/thuliteio/doks.git themes/doks

If you can help me get the doc stack running, I'd be happy to contribute docs as I learn.

Nexucis commented 3 weeks ago

Yeah I think we need to spend more time on the website to make it easier to run it / build it.

For the moment if you want to help on the documentation on Perses, you can do it by submitting PR in the upstream repo. There is a folder docs where that contains all documentation about Perses.

agardnerIT commented 3 weeks ago

Thanks. Opened #32 .

Would you be open to reworking it in mkdocs? I'm happy to build a POC for a new doc stack and volunteer to maintain it?