Hello Thomas,
Viktor Ransmayr schrieb am Samstag, 18. März 2023 um 18:28:05 UTC+1:

tbp1...@gmail.com schrieb am Freitag, 17. März 2023 um 14:39:46 UTC+1:

The following script will build everything except the slides.  Either it 
needs to be run from the *leo/doc* directory or the path needs to be added 
to the script instead of the "." in the last line:

#see https://github.com/leo-editor/leo-editor/issues/1566
import sys
import subprocess
pyexe=sys.executable
cmd=[pyexe,'-m','sphinx','-C',
'-D', 'master_doc=html/leo_toc',
'-D', 'source_suffix=.html.txt',
'-D', 'html_theme=sphinx_rtd_theme',
'-D', 'project=LeoDocs',
'.', r'c:\temp\result']

subprocess.call(cmd)

To use the theme, IIRC, it needs to be installed from PyPi first.  Run the 
script with the usual CNTL-b.

I first worked this up in 2020.  I just now tried it out to see if it still 
works by pasting it into a new node at the top of the LeoDocs outline.  
Change the "result" location in the last line to suit yourself.


I used a slightly simpler version, since I did not want to add any 
dependency & make it non-windows specific:

import sys
import subprocess
pyexe = sys.executable
cmd = [pyexe, '-m', 'sphinx', '-C', 
          '-D', 'master_doc=html/leo_toc',
          '-D', 'source_suffix=.html.txt',
          '-D', 'project=Leo Docs',
          '.', 'result']

subprocess.call(cmd)

It works kind of OK - but - did reveal, that Leo's Documentation Outline is 
still assuming that development & release work is done on Windows ...


I should have made the issue more explicit ...

The problem is that  Leo's Documentation Outline is still using backslashes 
"\" , which are kept / visible even on Linux, i.e. 

###

user@debian-leo-study-vm:~/PyVE/GitHub/Leo/leo-editor/leo/doc/result$ ls
 genindex.html                    'html\tutorial-basics.html'
 html                             'html\tutorial.html'
'html\cheatsheet.html'            'html\tutorial-pim.html'
'html\coloring.html'              'html\tutorial-rst3.html'
'html\console-gui.html'           'html\tutorial-scripting.html'
'html\debuggers.html'             'html\tutorial-tips.html'
'html\emacs.html'                 'html\vimBindings.html'
'html\FAQ.html'                   'html\writingPlugins.html'
'html\IPythonBridge.html'          _images
'html\leoBridge.html'              objects.inv
'html\leonine-world.html'          search.html
'html\leo_toc.html'                searchindex.js
'html\leo-university.html'         _sources
'html\scripting-miscellany.html'   _static
user@debian-leo-study-vm:~/PyVE/GitHub/Leo/leo-editor/leo/doc/result$ 

###

With kind regards,

Viktor

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to leo-editor+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/43ca87f8-9b14-48de-bf27-59f8a8aea4c4n%40googlegroups.com.

Reply via email to