diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index cc622c3..264ec21 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -70,6 +70,22 @@ jobs: runs-on: ubuntu-latest needs: build steps: - - name: Deploy to GitHub Pages + - name: Deploy dev + uses: peaceiris/actions-gh-pages@v4 + # Dev site built on PRs + if: | + (github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository) || + (github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'dev') || + (github.event_name == 'push' && (contains(steps.vars.outputs.tag, 'a') || contains(steps.vars.outputs.tag, 'b') || contains(steps.vars.outputs.tag, 'rc'))) + with: + personal_token: ${{ secrets.HOLOVIZ_ACCESS_TOKEN }} + external_repository: holoviz-dev/panel-reactflow + publish_dir: ./builtdocs + force_orphan: true + - name: Deploy main + if: | + (github.event_name != 'pull_request') && + ((github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'main') || + (github.event_name == 'push' && !(contains(steps.vars.outputs.tag, 'a') || contains(steps.vars.outputs.tag, 'b') || contains(steps.vars.outputs.tag, 'rc')))) id: deployment uses: actions/deploy-pages@v4 diff --git a/docs/assets/screenshots/examples/advanced.png b/docs/assets/screenshots/examples/advanced.png new file mode 100644 index 0000000..a5eb967 Binary files /dev/null and b/docs/assets/screenshots/examples/advanced.png differ diff --git a/docs/assets/screenshots/examples/custom_editor.png b/docs/assets/screenshots/examples/custom_editor.png new file mode 100644 index 0000000..ec98146 Binary files /dev/null and b/docs/assets/screenshots/examples/custom_editor.png differ diff --git a/docs/assets/screenshots/examples/edge_editors.png b/docs/assets/screenshots/examples/edge_editors.png new file mode 100644 index 0000000..7a4425c Binary files /dev/null and b/docs/assets/screenshots/examples/edge_editors.png differ diff --git a/docs/assets/screenshots/examples/node_edge_instances.png b/docs/assets/screenshots/examples/node_edge_instances.png new file mode 100644 index 0000000..378c3c1 Binary files /dev/null and b/docs/assets/screenshots/examples/node_edge_instances.png differ diff --git a/docs/assets/screenshots/examples/schema_types.png b/docs/assets/screenshots/examples/schema_types.png new file mode 100644 index 0000000..2bebb6b Binary files /dev/null and b/docs/assets/screenshots/examples/schema_types.png differ diff --git a/docs/assets/screenshots/examples/simple.png b/docs/assets/screenshots/examples/simple.png new file mode 100644 index 0000000..1d47891 Binary files /dev/null and b/docs/assets/screenshots/examples/simple.png differ diff --git a/docs/assets/screenshots/examples/threejs_viewer.png b/docs/assets/screenshots/examples/threejs_viewer.png new file mode 100644 index 0000000..d501b59 Binary files /dev/null and b/docs/assets/screenshots/examples/threejs_viewer.png differ diff --git a/docs/assets/screenshots/examples/threejs_viewer_instances.png b/docs/assets/screenshots/examples/threejs_viewer_instances.png new file mode 100644 index 0000000..a39e940 Binary files /dev/null and b/docs/assets/screenshots/examples/threejs_viewer_instances.png differ diff --git a/docs/examples.md b/docs/examples.md deleted file mode 100644 index 755e73e..0000000 --- a/docs/examples.md +++ /dev/null @@ -1,13 +0,0 @@ -# Examples - -```{.python pycafe-embed pycafe-embed-style="border: 1px solid #e6e6e6; border-radius: 8px;" pycafe-embed-width="100%" pycafe-embed-height="400px" pycafe-embed-scale="1.0"} -import panel as pn -pn.extension() - -x_slider = pn.widgets.IntSlider(name='x', start=0, end=100) - -def apply_square(x): - return f'{x} squared is {x**2}' - -pn.Row(x_slider, pn.bind(apply_square, x_slider)) -``` diff --git a/docs/examples/advanced.md b/docs/examples/advanced.md new file mode 100644 index 0000000..bc6c5b2 --- /dev/null +++ b/docs/examples/advanced.md @@ -0,0 +1,12 @@ +# Advanced + +Schema-driven editor workflow with a custom node type, type stylesheets, +and top-panel event feedback. + + + +## Source + +```python +--8<-- "examples/advanced.py" +``` diff --git a/docs/examples/custom-editor.md b/docs/examples/custom-editor.md new file mode 100644 index 0000000..ad8d740 --- /dev/null +++ b/docs/examples/custom-editor.md @@ -0,0 +1,12 @@ +# Custom Editor + +Registers a callable editor for `metric` nodes and pushes incremental updates +using `on_patch`. + + + +## Source + +```python +--8<-- "examples/custom_editor.py" +``` diff --git a/docs/examples/edge-editors.md b/docs/examples/edge-editors.md new file mode 100644 index 0000000..3baa635 --- /dev/null +++ b/docs/examples/edge-editors.md @@ -0,0 +1,12 @@ +# Edge Editors + +Shows schema-backed edge editing plus a custom callable edge editor for +specialized edge types. + + + +## Source + +```python +--8<-- "examples/edge_editors.py" +``` diff --git a/docs/examples/index.md b/docs/examples/index.md new file mode 100644 index 0000000..92d69ed --- /dev/null +++ b/docs/examples/index.md @@ -0,0 +1,64 @@ +# Examples Gallery + +Browse runnable examples from `examples/`. Each card links to a dedicated page +with a screenshot and full source code. + +