Quarto Dashboard Rendering without Internet Connection !!

[udaybmg]

Description

Hi everyone,

I have an interesting challenge with generating Quarto reports using Python. Here’s the setup:

Files:

MainCode.py: Handles data collection, formatting, and generates variables for _quarto.yml.
Create_Lot_Summary.ipynb: Contains the core Python code for calculations and plots.
_quarto.yml: Configuration file for the Quarto dashboard.
Code Overview:

MainCode.py generates the _quarto.yml file with the following content:

data = {
    "title": "Summary for " + Lot_id,
    "output-file": Lot_id + "_Summary_" + timestamp + ".html",
    "project": {
        "output-dir": _path + "/"
    },
    "date": "today",
    "date-format": "long",
    "format": {
        "dashboard": {
            "scrolling": True,
            "link-external-newwindow": True,
            "embed-resources": False,
            "url": "./require.min.js"
        }
    },
    "execute": {
        "echo": False,
        "enabled": True
    },
    "theme": "custom.scss",
    "jupyter": "python3"
}

# Write to _quarto.yml
with open("_quarto.yml", "w") as f:
    yaml.dump(data, f)

After generating _quarto.yml, the following command renders the Quarto dashboard:

# Render Quarto to HTML
terminalcom_1 = 'quarto render Create_Lot_Summary_V1.ipynb'
subprocess.run(terminalcom_1.split(), shell=True, check=True)

The Problem:

When "embed-resources": False, the rendering creates an HTML file and a folder with supporting files.
When "embed-resources": True, the rendering creates a single HTML file with all resources embedded, but it requires an active internet connection to download files like jquery.min.js, require.min.js and may be more .

Question:

How can I ensure the rendering works without an internet connection, especially when "embed-resources": True?

Looking forward to your suggestions and solutions!

[cscheid]

We need an actual repository with the code to be able to help - a description like this is not enough to reproduce.

[udaybmg]

@cderv and @cscheid Checking to see if you have any solution/suggestions on the issue. Please do let me know.

[cderv]

I've found that setting embed-resource='False' allows rendering to work offline. However, if the import is being made by a dependency, it should still happen even with embed-resource='False', right? I'm still curious about the underlying cause which might help to find solution.

When you set embed-resources: false, Quarto will not try to embed the resources inside the HTML file. When embed-resources: true, any external dependencies will be inlined in the document. If you have some python code that linked to a dependency online, it can cause your problem here:

• embed-resources: false: Quarto does nothing specific. When you will open your HTML in the browser, the dependency will be fetched. You need an internet connection at viewing time !
• embed-resources: true: Quarto will see the dependency that has been brought by your python code inside the HTML file. As embedding is asked for, Quarto will do another pandoc run to embed all the resources, including online one. They will be fetched to be inlined. You need an internet connection at rendering time !

I hope this clarify.

[udaybmg]

Thanks @cderv . I have tried this again and again. The results are same, When I set embed-resources = False, the rendering occurs without requiring an internet connection. Even to view rendered HTML file I don't need internet. Its not the case when I embed-resources = True, It tries to access internet even to start rendering.

I use the script to analyze and visualize local data local, so python code doesn't need internet access.

[cderv]

Even to view rendered HTML file I don't need internet.

Can you check you browser console and confirm that no resources are 404 and can't be loaded ? If you have no internet connection, then external resources should be erroring when being fetch by your browser.

I will try again your example but I don't see what else could be happening. embed-resources: true expects an internet connection to fetch any external resources that are in the HTML file so that they are embed.

[cderv]

After some manipulation, I manage to make your example reproducible on my side. (please next time provide a ipynb that can be run without having to rely on a .py script)

First thing I can see by opening the HTML file is some <script loading from https://. So there are online resources in your HTML and when you'll try to embed then at rendering time, it requires an internet connection.

Quarto does insert some of them (for example we insert JQuery, require.js and others like @jupyter-widgets/html-manager when we detect Jupyter Widgets so that they can work.)

You are also using itables which will load associated JS script from online.

So overall you need an internet connection. Either at rendering time or at viewing time.