Block "Edit annotations", "Generate output" buttons if no annotations exist / no screenshots taken

[miiranta]

Summary

Error is edge cases of some of the main buttons.

Steps to reproduce

Just click Edit Annotation before taking any screenshots OR
Just click Generate output before generating annotations

Traceback (most recent call last):
  File "C:\Users\Lucas Miranda\AppData\Local\slicer.org\3D Slicer 5.11.0-2025-11-16\bin\Python\slicer\util.py", line 3392, in tryWithErrorDisplay
    yield
  File "C:/Users/Lucas Miranda/Desktop/SlicerTutorialMaker/TutorialMaker/TutorialMaker.py", line 274, in Generate
    AnnotationPainter.TutorialPainter().GenerateHTMLfromAnnotatedTutorial(Lib.TutorialUtils.get_module_basepath("TutorialMaker") + "/Outputs/Annotations/annotations.json")
  File "C:\Users\Lucas Miranda\Desktop\SlicerTutorialMaker\TutorialMaker\Lib\TutorialPainter.py", line 806, in GenerateHTMLfromAnnotatedTutorial
    [self.TutorialInfo, self.slides, self.imagePaths] = AnnotatedTutorial.LoadAnnotatedTutorial(path)
                                                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Lucas Miranda\Desktop\SlicerTutorialMaker\TutorialMaker\Lib\Annotations.py", line 507, in LoadAnnotatedTutorial
    textDict = AnnotatedTutorial.GetLocalizedDict(currentLanguage)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Lucas Miranda\Desktop\SlicerTutorialMaker\TutorialMaker\Lib\Annotations.py", line 493, in GetLocalizedDict
    with open(dictPath, encoding='utf-8') as file:
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: 'C:\\Users\\Lucas Miranda\\Desktop\\SlicerTutorialMaker\\TutorialMaker\\Lib/../Outputs/Annotations/text_dict_default.json'

Environment

Slicer 5.11.0
Windows 10
Tutorial Maker version: 960d1f3 (main) -
Merge pull request #117 from SlicerLatinAmerica/hotfix-imagesize-mac

[miiranta]

After capturing the screenshots of the 4 Minute Tutorial and clicking immediately "Generate Output", the following error is shown:

Traceback (most recent call last):
  File "C:\Users\Lucas Miranda\AppData\Local\slicer.org\3D Slicer 5.11.0-2025-11-16\bin\Python\slicer\util.py", line 3392, in tryWithErrorDisplay
    yield
  File "C:/Users/Lucas Miranda/Desktop/SlicerTutorialMaker/TutorialMaker/TutorialMaker.py", line 274, in Generate
    AnnotationPainter.TutorialPainter().GenerateHTMLfromAnnotatedTutorial(Lib.TutorialUtils.get_module_basepath("TutorialMaker") + "/Outputs/Annotations/annotations.json")
  File "C:\Users\Lucas Miranda\Desktop\SlicerTutorialMaker\TutorialMaker\Lib\TutorialPainter.py", line 806, in GenerateHTMLfromAnnotatedTutorial
    [self.TutorialInfo, self.slides, self.imagePaths] = AnnotatedTutorial.LoadAnnotatedTutorial(path)
                                                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Lucas Miranda\Desktop\SlicerTutorialMaker\TutorialMaker\Lib\Annotations.py", line 507, in LoadAnnotatedTutorial
    textDict = AnnotatedTutorial.GetLocalizedDict(currentLanguage)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Lucas Miranda\Desktop\SlicerTutorialMaker\TutorialMaker\Lib\Annotations.py", line 493, in GetLocalizedDict
    with open(dictPath, encoding='utf-8') as file:
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: 'C:\\Users\\Lucas Miranda\\Desktop\\SlicerTutorialMaker\\TutorialMaker\\Lib/../Outputs/Annotations/text_dict_default.json'

If this behavior is expected, then we should block the "Generate output" button until annotations/screenshots exist.

[miiranta]

Also, haven't we implemented PDF output? Because there's no PDF/Slides output, just images

[DouSam]

Also, haven't we implemented PDF output? Because there's no PDF/Slides output, just images

We generate MD and HTML output, and you can generate the PDF using the print function from your browser. There is no need to use external libraries just to generate PDF.

[DouSam]

For those who will work on that one, for some reason user can click on these buttons, and we don't have annotations or screenshots captured, please show an error in a box for the user.
If the user clicked on edit annotations before caputre: "Before edit annotations you should run the capture of the screenshots, select a tutorial and click on "Capture Screenshots""
If the user clicked on export before annotate: "You dont have any annotations to export, do you want to export just the screenshots?" and if he select yes, we can export without annotations.

[miiranta]

Added new popup warnings in #135