This repository contains the HoloViz blog, which is built using Quarto.
Begin by installing Quarto:
conda create -n holoviz-blog -c conda-forge r-quarto perl
conda activate holoviz-blog
To contribute to this repository, start by copying the /posts/template
folder and renaming it as desired. This folder includes:
index.ipynb
file, which is your blog notebook. This can also be a Markdown file. The file must contain a special header (in a raw
cell or Markdown format) that you need to customize.images
folder to store all images and assets linked from your post, e.g., ![](./images/example.png)
.repro
folder to include any materials that will help reproduce your post in the future, such as lock files.From the repository root, run quarto preview
. This command will build the site and open a tab in your browser for a live preview. Updates to the repository files will be reflected immediately.
When you're ready to contribute a new blog post or an edit, open a pull request (PR) and commit your files. If you're committing a notebook, ensure it is committed in its evaluated state. The development site is rebuilt every time you push a commit to a PR. Check that your blog post appears as expected. The main site will be updated once the PR is merged.