[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

rocm-docs-core



Hello

I pushed a reasonnably almost working version here :
https://salsa.debian.org/bayle/rocm-docs-core/-/pipelines/829058

I mean buy this that I could build documentation running

python3 -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html

in the docs directory of at least :

hipblas  hipsparse rocm-docs-core

but it require some missing package you can quick and dirty build:
-python3-sphinx-external-toc (easy py2deb)
-python3-doxysphinx,(easy dh_make --python)
-python3-mpire,(easy py2deb)

it also requires python3-pydata-sphinx-theme from experimental

It is only necessary if you want to build the doc.
The autotest are ok.


It require a git clone with https, don't work without a little hack with git+ssh.
It also has some hardcoded url to download index.

The good point, is that it should make possible to remove some patch in other rocm packages.

It would need some reviewer, and some feedback to know if it's worth to upload for you, or to wait the dependencies and patch to make this offline.

It should be license clean, it is lintian clean, there are many override
because the theme embeds font not in font dir and few other stuff like this, i looked at some similar sphinx theme, that do the same.

There is no doc package as it can't be generated offline.


Cheers

Christian


Reply to: