ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs ScyllaDB Sphinx Theme Getting started Quickstart

Caution

You're viewing documentation for a previous version of ScyllaDB Sphinx Theme. Switch to the latest stable version.

Quickstart¶

This guide will show you how to create your first documentation page, list it in the table of contents, and preview the site locally.

Prerequisites¶

You must have a project cloned locally with the documentation toolchain. Additionally, you will need to have installed:

  • A Unix-based terminal. For Windows, use Windows Subsystem for Linux.

  • Python 3.10.

  • Poetry 1.8.1.

  • Make.

  • Git.

Step 1: Create a new doc¶

Under the docs folder (docs/source in some projects), create a new .rst file.

For example, we named our file my-new-page.rst and added the following content:

=============
My first page
=============

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas id risus laoreet libero bibendum pharetra non ut sem. Curabitur in nulla diam.
Donec scelerisque neque lectus, et fringilla eros vestibulum vel. Suspendisse vitae dolor volutpat, lobortis libero a, commodo mi.
Aenean pretium neque sit amet erat vulputate laoreet. Mauris dapibus vel dui sit amet bibendum.

Tip

If you are not familiar with restructuredText syntax, refer to Examples.

Step 2: Add the page to the toc tree¶

When creating new pages, you must add the topic to the toc tree. If you do not you will have an error when compiling.

To add the page to the toc tree:

  1. Look in the folder you have created the page and find the index.rst file which is inside the same directory.

  2. Edit the toctree directive to include the name of the new topic without its extension. For example:

    .. toctree::
       :maxdepth: 2
    
       my-new-page
    
  3. Save the file.

Step 3: Preview the docs locally¶

Included in every existing documentation project is a make file. This file contains scripts that you can run to create a testing environment, compile the docs, and produce a local sandbox (website) to test the rendering of the HTML documentation.

To preview the docs locally:

  1. From the command line, run make preview within the docs folder.

  2. Open http://127.0.0.1:5500/ to preview the generated site with you changes.

From the Make file (located in most projects in the /docs/makefile directory), there are more scripts you can run. For more information, see Commands.

Next steps¶

Do you want to submit your changes? See our Docs contributor’s handbook.

Was this page helpful?

PREVIOUS
Installation
NEXT
Configuration
  • Create an issue
  • Edit this page

On this page

  • Quickstart
    • Prerequisites
    • Step 1: Create a new doc
    • Step 2: Add the page to the toc tree
    • Step 3: Preview the docs locally
    • Next steps
ScyllaDB Sphinx Theme
  • 1.7
    • 1.8
    • 1.7
    • 1.6
    • 1.5
    • 1.4
    • 1.3
    • 1.2
    • 1.1
  • Getting started
    • Toolchain
    • Installation
    • Quickstart
  • Configuration
    • Template options
    • Page options
    • Multiversion options
    • Markdown support
    • Redirects support
    • Search support
  • Commands
  • Deployment
    • Production deployment
    • Pull requests previews
  • Examples
    • Admonitions
    • Collapse
    • Code blocks
    • Glossary
    • Headings
    • Hero box
    • Includes
    • Images
    • Labels
    • Links
    • Lists
    • Panel box
    • Substitutions
    • Tables
    • Tabs
    • Text
    • TOC
    • Topic box
    • Versions
  • Upgrade guides
    • Migrating from 1.6 to 1.7
    • Migrating from 1.5 to 1.6
    • Migrating from 1.4 to 1.5
    • Migrating from 1.3 to 1.4
    • Migrating from 1.2 to 1.3
    • Migrating from 1.1 to 1.2
    • Migrating from 1.0 to 1.1
    • Migrating from 0.x to 1.0
    • Changelog
  • Contribute
    • Contribute to the documentation
    • Contribute to the theme
    • Source Code
Docs Tutorials University Contact Us About Us
© 2025 ScyllaDB | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 01 Apr 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.6
Ask AI