
Hello together, it seems that BIT does use Sphinx. I can see the reStructuredText in the codes docstrings. But I can't find the HTML docu generated from that docstrings. Not sure what the correct term is here for documentation that was generated out of docstrings: "Reference"? Does anyone know if there is such a docu? If not is anyone able to generate such a docu quick and dirty from the current main branch and can send it to me or somewhere else? It doesn't have to go into the official repo yet. It just would help me a lot to better understand the code and the structure of the project. I have used Sphinx a bit but I'm not quit familiar with it. And I won't touch Sphinx. ;) Btw: I am aware of the separate docu repo: https://github.com/bit-team/doc But it seems to me that this only is kind of a "User manual" and does not reference to the code. Kind Christian

Hi Christian, I'm attaching a compressed version of the documents I have just generated. It's turned out to be actually pretty simple. For further reference, it can be done as follows. 1. You need to have python3-sphinx package installed for Debian. 2. Checkout to code. 3. Navigate to common/doc-dev 4. Call "make html". It'll create the documents under "_build" folder. Open "_build/html/index.html", and you're done. If you wish, I can setup a pipeline which can pull the repo once a week, generate the documents and put somewhere online. I also use Vagrant extensively, and can create an automated document generator VM and share here, too. Cheers, Hakan On 22.08.2022 16:03, c.buhtz@posteo.jp wrote:

Hi, as Hakan already pointed out the docu can be build with `make html` run inside `common/doc-dev/`. But there is also an online version at https://backintime-dev.readthedocs.org/ There is a build service at readthedocs but it seems like that isn't working automatically at the moment. Also https://backintime.readthedocs.org/ doesn't build at all at the moment. I'll have a look...

Hi Christian, I'm attaching a compressed version of the documents I have just generated. It's turned out to be actually pretty simple. For further reference, it can be done as follows. 1. You need to have python3-sphinx package installed for Debian. 2. Checkout to code. 3. Navigate to common/doc-dev 4. Call "make html". It'll create the documents under "_build" folder. Open "_build/html/index.html", and you're done. If you wish, I can setup a pipeline which can pull the repo once a week, generate the documents and put somewhere online. I also use Vagrant extensively, and can create an automated document generator VM and share here, too. Cheers, Hakan On 22.08.2022 16:03, c.buhtz@posteo.jp wrote:

Hi, as Hakan already pointed out the docu can be build with `make html` run inside `common/doc-dev/`. But there is also an online version at https://backintime-dev.readthedocs.org/ There is a build service at readthedocs but it seems like that isn't working automatically at the moment. Also https://backintime.readthedocs.org/ doesn't build at all at the moment. I'll have a look...
participants (4)
-
c.buhtz@posteo.jp
-
Germar Reitze
-
Hakan Bayındır
-
Rita Arrington