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-blogTo contribute to this repository, start by copying the /posts/template folder and renaming it as desired. This folder includes:
- An
index.ipynbfile, which is your blog notebook. This can also be a Markdown file. The file must contain a special header (in arawcell or Markdown format) that you need to customize. - An
imagesfolder to store all images and assets linked from your post, e.g.,. - A
reprofolder 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.