Publishing Notebooks¶
Publish a notebook to keep an immutable copy of its source and outputs in Zelos Cloud, where your team can read it, download it, or open it in the Zelos App.
Publish a notebook¶
In the app, choose Share in the notebook header, then Publish. From the command line, run:
Each publish adds a new version: the source snapshot plus the latest settled
outputs. Publishing does not run cells, so a version carries the outcome of the
run that produced those outputs — including failed, when an assertion stopped
it. Errored and failed runs publish too: a failed test is exactly the run
someone needs to see. Add --publish to zelos notebook run to run and publish
in one step; see Notebooks as tests.
A published notebook counts against your organization's cloud storage, and the plan sets how many cloud notebooks the organization can have.
See Publish and share with Zelos Cloud
for versions, the remote block, and every CLI flag.
Share it¶
Choose who can open the cloud notebook:
| Access | Who can open it |
|---|---|
| Only me | The notebook owner |
| Organization | Everyone in the selected organization |
| Public link | Anyone who has a link for a specific published version |
Organization links work like trace links: they carry no credentials, and only members of the organization can open them. A public link opens for anyone who has it. It stays pinned to the version it was created for, and switching the notebook back to a restricted setting revokes every public link.
Open a published notebook¶
Open the link in your browser and sign in if prompted. The console page renders the notebook and offers Open in Zelos App, a source download, and the version history. See Manage published notebooks.
Open in Zelos App shows the same published version in a read-only tab in the desktop app. From there, Save to library puts an editable copy in your notebooks folder. See Read a cloud notebook.
From a terminal, zelos notebook pull <ID> saves a published notebook into your
notebooks folder; see the CLI reference.
Delete a published notebook¶
Delete a notebook from its console page or from the app. Its cloud storage is released after a 24-hour grace period.