The new docs site is here:
https://gitlab.com/CentOS/docs/docs.centos.orgamp
I'd like to get some CD set up to publish to something like docs-new.centos.org, so we can preview the work. Then when it's ready, it should be a simple switchover. I'm able to build with just: mkdocs build. For dependencies: pip install mkdocs mkdocs-material mkdocs-monorepo-plugin. IMPORTANT: mkdocs is in Fedora's repos, but when I got it from dnf, it didn't like the mkdocs-material I got from pip. Getting everything from pip worked for me.
mkdocs build
pip install mkdocs mkdocs-material mkdocs-monorepo-plugin
Metadata Update from @arrfab: - Issue tagged with: centos-common-infra, medium-gain, medium-trouble
If that's on gitlab you can already use the gitlab ci/cd to automatically render pages there . What I'd like to know though is more about the final setup, so instructions about how to render this so that it would be pushed out for real docs.centos.org instance.
Can you elaborate about that plan ? for current other docs sections using mkdocs, it's using the docker.io/squidfunk/mkdocs-material:latest container. Does that need to change for the new docs website ? Having a discussion about it would be a good idea, as an issue tracker isn't the best place for this :) (imho)
docker.io/squidfunk/mkdocs-material:latest
Metadata Update from @arrfab: - Issue priority set to: Waiting on Reporter (was: Needs Review) - Issue tagged with: need-more-info
Metadata Update from @arrfab: - Issue assigned to arrfab
@shaunm : as we can't directly use the existing mkdocs-material container, I just built a new mkdocs-centos container that seems to have all required packages. It's available at https://quay.io/repository/centosci/mkdocs-centos?tab=info and I'll create a new ansible role that will setup a vhost , itself :
mkdocs-centos
Would that work for you ?
https://docs.stg.centos.org/ is now live and so should be updated on regular basis (process is checking upstream git repo every two minutes for commit hash and call mkdocs build (through podman) if needed.
Feel free to reopen if you need anything else (initial request had no real requirements, so we had to figure that ourselves ...)
Metadata Update from @arrfab: - Issue close_status updated to: Fixed with Explanation - Issue status updated to: Closed (was: Open)
I didn't see this ticket until now. In case it helps, we had already setup the gitlab CI for testing on that repo: https://docs-centos-org-centos-docs-5f8c3c51aa463473c5b967945c3cf462908.gitlab.io/ so if it's easier we could have this hosted by gitlab pages directly.
Log in to comment on this ticket.