https://rocm-team.pages.debian.net/ Page and rocm-docs-build
Hello,
on salsa/gitlab, if you name a project
<group-name>/<group-name>.pages.debian.net
you can setup an automatically generated site on gitlab pages
I used this feature there:
https://salsa.debian.org/rocm-team/rocm-team.pages.debian.net
I added a script that extract information from
* github/ROCm api
* salsa/rocm-team api
* udd database
to make some kind of synthetic view of ROCm state
(inspired from https://wiki.debian.org/Teams/ROCm bottom of the page)
the rocm-readme-gen script is available in the repo [1],
but is not (yet?) run by the ci/cd
it require a gihub token to work properly (feel free to update if
somthing you know changed)
the ci/cd is at the moment installing the rocm-doc package [2]
and copy the generated doc as a front page for
https://rocm-team.pages.debian.net/
I will probably try to eat my own dog food to make something more debian
specific using the rocm-readme-gen script and rocm-docs python lib
Will probably try to put there the doc from the various rocm doc packages.
there is a new script in python3-rocm-docs (>=1.23.0-5) in unstable:
- rocm-docs-build that you should be able to use in your debian/rules
like this:
---
execute_after_dh_auto_build-indep: export http_proxy=127.0.0.1:9
execute_after_dh_auto_build-indep: export https_proxy=127.0.0.1:9
execute_after_dh_auto_build-indep:
ifeq (,$(filter nodoc,$(DEB_BUILD_OPTIONS)))
rocm-docs-build
endif
---
I have to finish some tests with rocblas and others, let me know if you
hit some problems, if you use it.
you can also use this on a git clone of a ROCm repo, this may retrieve
data from internet, and fix some links.
the main problem remains to tell to intersphinx to use local object.inv
they should be added in the debian/projects.yaml file in the
rocm-docs-core source package to be available in
/usr/lib/python3/dist-packages/rocm_docs/data/projects.yaml from the
python3-rocm-docs package
even if the inv files are not available the build should run (with some
warning/error) as the rocm-docs-build tries to disable mandatory online
intersphinx query.
Feel free to update debian/projects.yaml when you generate a new object.inv
I also added a file in python3-rocm-docs
cat /usr/share/doc/python3-rocm-docs/rocm_data
rocm-docs/rocm_data
latest_version=6.4.3
release_candidate=7.0.0
google_site_verification=vo35SZt_GASsTHAEmdww7AYKPCvZyzLvOXBl8guBME4
It contains some info that are normaly downloaded at doc build
It comes from the data branch of the ROCm/rocm-docs-core data branch
[3].(took me some time to figure this out)
Regards
Christian B.
[1]
https://salsa.debian.org/rocm-team/rocm-team.pages.debian.net/-/blob/main/script/rocm-readme-gen?ref_type=heads
[2]
https://salsa.debian.org/rocm-team/rocm-team.pages.debian.net/-/blob/main/.gitlab-ci.yml?ref_type=heads
[3] https://github.com/ROCm/rocm-docs-core/blob/data/latest_version.txt
https://github.com/ROCm/rocm-docs-core/blob/data/release_candidate.txt
https://github.com/ROCm/rocm-docs-core/blob/data/google_site_verification.txt
Reply to: