Skip to main content

Website Index

This section documents the main structure of the vania-novikau.me website and environment configurations.

Project Paths​

Here are the critical root directories for both local development and the remote production server.

Remote Host (Production)​

Additional details about the server environment (<remote_host>).

  • Root Directory: /var/www/html/
    • This is the main document root containing the deployed site.
    • Subdirectories include wp-content/, documentation/, and rag-service/.

Local Host (Development)​

The development environment path may vary depending on the setup (WSL vs. bare metal).

  • Standard Path: <local_root>/
  • Alternative Path: /root/sites/vania-novikau.me/
    • Ensure you are working in the correct workspace root mapped to your editor.

Documentation Site URLs​

The documentation site is served by a Docusaurus Docker container (html-docusaurus-1) with baseUrl: /documentation/ and the default docs routeBasePath: docs.

URL pattern for all documentation pages:

https://vania-novikau.me/documentation/docs/<category>/<page-id>
PageURL
Index (this page)https://vania-novikau.me/documentation/docs/website
Changeloghttps://vania-novikau.me/documentation/docs/changelog
Introductionhttps://vania-novikau.me/documentation/docs/intro
Glossaryhttps://vania-novikau.me/documentation/docs/glossary
Ops: Content Fixeshttps://vania-novikau.me/documentation/docs/ops/content-fixes
Ops: Deploymenthttps://vania-novikau.me/documentation/docs/ops/deployment
Ops: Workflowhttps://vania-novikau.me/documentation/docs/ops/workflow
Ops: Agentshttps://vania-novikau.me/documentation/docs/ops/agents
Website: Authhttps://vania-novikau.me/documentation/docs/website/auth
Website: Posthttps://vania-novikau.me/documentation/docs/website/post
caution

Always include /docs/ between /documentation/ and the page path. The root https://vania-novikau.me/documentation/ serves only the Docusaurus landing page, not individual docs.

Docker Container Notes​

  • Container: html-docusaurus-1 on <remote_host>
  • No bind mount — files are baked into the image. After every rsync deploy, a docker cp is required to push new files into the running container: 
    docker cp /var/www/html/documentation/. html-docusaurus-1:/usr/share/nginx/html/documentation/

Source Control & Branches​

The project repository uses the following branching strategy:

  • ai-tabs: The leading production branch. All active development, new features, and fixes go here. This branch is what the remote host (<remote_host>) runs, and it is the source of truth.
  • main: The archive branch. It is kept in sync with ai-tabs (via regular merges) to preserve a snapshot of the code, but is not used for active development or deployment.

Workflow: develop and deploy on ai-tabs → periodically merge ai-tabs into main to archive.