提交: 07612377f02795d6b2b3ea160355fe7136d49115 - DocIdeas (hg)

Commit MetaInfo

• 修订版: 07612377f02795d6b2b3ea160355fe7136d49115 (tree)
• 时间: 2024-04-29 19:47:06
• 作者: Albert Mietus < albert AT mietus DOT nl >
• Commiter: Albert Mietus < albert AT mietus DOT nl >

Log Message

RTD: last try worked, Now: cleanu ( and test)

更改概述

• modified: .readthedocs.yaml
• modified: conf.py

差异

diff -r 515a83c1a357 -r 07612377f027 .readthedocs.yaml
--- a/.readthedocs.yaml	Mon Apr 29 12:29:50 2024 +0200
+++ b/.readthedocs.yaml	Mon Apr 29 12:47:06 2024 +0200
@@ -11,11 +11,14 @@
   #  python: "3.11"
      python: "3.9"
   apt_packages:
-  # python3-sphinxcontrib.plantuml install an old one version.
-  # Better to replace it by pip, so the requerments-file, which is already done
+  # python3-sphinxcontrib.plantuml installs an old version of plantuml ...
+  # But is needed, to install dependencies ..
+  # Below, an other plantUML jar is installed
+  # (Both are needed ... it also in the requerments-file, but needed here)
     - python3-sphinxcontrib.plantuml
   jobs:
     post_install:
+      # Install a  newer version op plantuml -- keep in sync witch 'conf.py'!
       - mkdir -p ${READTHEDOCS_VIRTUALENV_PATH}/libexec
       - curl  -o ${READTHEDOCS_VIRTUALENV_PATH}/libexec/plantuml.jar  -L https://github.com/plantuml/plantuml/releases/download/v1.2024.4/plantuml-1.2024.4.jar
 

diff -r 515a83c1a357 -r 07612377f027 conf.py
--- a/conf.py	Mon Apr 29 12:29:50 2024 +0200
+++ b/conf.py	Mon Apr 29 12:47:06 2024 +0200
@@ -74,23 +74,19 @@
 #---------
 
 extensions.append('sphinxcontrib.plantuml')
-if True or on_rtd:
-    print('DEBUG: on_rtd')
-    if False: #old
-        plantuml = 'java  -Djava.awt.headless=true  -jar /usr/share/plantuml/plantuml.jar'
-    else:
-        #  in `.readthedocs.yaml`
-        #     post_install:
-        #      - curl -o ${READTHEDOCS_VIRTUALENV_PATH}/libexec/plantuml.jar -L https://github.com/plantuml/....
-        import os
-        _path=os.environ['READTHEDOCS_VIRTUALENV_PATH'] + '/libexec/'
-        plantuml = f'java  -Djava.awt.headless=true  -jar {_path}plantuml.jar'
-        print(f'DEBUG: plantuml={plantuml}')
+if on_rtd:
+    #  in `.readthedocs.yaml`
+    #     post_install:
+    #      - curl -o ${READTHEDOCS_VIRTUALENV_PATH}/libexec/plantuml.jar -L https://github.com/plantuml/....
+    # Make use of that plantUML version
+    import os
+    _path=os.environ['READTHEDOCS_VIRTUALENV_PATH'] + '/libexec/'
+    plantuml = f'java  -Djava.awt.headless=true  -jar {_path}plantuml.jar'
+    #print(f'DEBUG: plantuml={plantuml}')
 else: #local
-#    plantuml = 'java  -Djava.awt.headless=true  -jar /Users/albert/Apps/PlantUML/libexec/plantuml-RTfD.jar'  #plantuml.1.2020.2.jar
-#    plantuml = 'plantuml'
     plantuml = 'java  -Djava.awt.headless=true  -jar /Users/albert/Apps/PlantUML/libexec/plantuml-1.2024.4.jar' # NEW
 
+
 ##plantuml_output_format='svg_img'
 ## dito only can be png?
 plantuml_output_format='png'