nguyent / duckdb-web

DuckDB-Web - Source code of duckdb.org

DuckDB Website

 

This repository hosts the source code for the DuckDB Website. Please file any questions or issues relating to the website or documentation here.

The main DuckDB repository is hosted here.

Adding a new page

First, thank you for your contribution!

Each new page requires at least 2 edits:

• The creation of a new markdown page with the documentation. Please follow the format of another .md file in the docs folder.
• Add a link to the new page within _data/menu_docs_dev.json. This populates the dropdown menus.

The addition of a new guide requires one additional edit:

• Add a link to the new page within the Guides landing page: docs/guides/index.md

Please test your changes using the steps listed in the Building section below.

When creating a PR, please check the box to "Allow edits from maintainers".

Please enclose code in blocks that are tagged with the appropriate language. (Ex: ```sql CODE HERE ```).

All examples should be self contained and reproducible if possible, meaning that any example tables are created as a part of the documentation.

Feedback is welcome on these contribution steps as well!

Building

Locally

The site is built using Jekyll. To build the site locally, install Ruby (using the version specified in the .ruby-version file), and run bundler to install the dependencies. If you are on Windows, you must then run these two commands:

gem uninstall eventmachine
gem install eventmachine --platform ruby

With a Dev Container

Click the green Code button to the top right to open a new codespace with this repository initialized.

Run dev server

Navigate to the directory where you have cloned duckdb-web and run

bundler exec jekyll serve --incremental --config _config.yml,_config_exclude_archive.yml --livereload

The website can then be browsed by going to localhost:4000 in your browser.

Generating code docs

Much of the documentation in this repository is automatically generated from the duckdb source code, or compiled binaries. The scripts that do this work are called from scripts/generate_all_docs.sh.