- Notifications
You must be signed in to change notification settings - Fork414
apache/doris-website
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
This repo is forApache Doris Website
And it use Github Action to automatically sync content fromApache Doris Code Repo
There are 2 Github Actions:
cron-deploy-website.yml
It will sync at 01:00 AM everyday from Doris's master branch.
manual-deploy-website.yml
It can only be triggered manually, and you can specify the branch name you want to sync.
To view the website, navigate tohttps://doris.apache.org
This website is built usingDocusaurus 2, a modern static website generator.
$ yarn$ yarn startThis command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
$ yarn buildThis command generates static content into thebuild directory and can be served using any static contents hosting service.
Using SSH:
$ USE_SSH=true yarn deployNot using SSH:
$ GIT_USER=<Your GitHub username> yarn deployIf you are using GitHub pages for hosting, this command is a convenient way to build the website and push to thegh-pages branch.
For how to submit pull requests, please refer to
.├── blog│ ├── 1.1 Release.md│ ├── Annoucing.md│ ├── jd.md│ ├── meituan.md│ ├── release-note-0.15.0.md│ ├── release-note-1.0.0.md│ └── xiaomi.md├── community│ ├── design│ │ ├── spark_load.md│ │ ├── doris_storage_optimization.md│ │ ├── grouping_sets_design.md│ │ └── metadata-design.md│ ├── ......├── docs│ ├── admin-manual│ │ ├── cluster-management│ │ ├── config│ │ ├── data-admin│ │ ├── http-actions│ │ ├── maint-monitor│ │ ├── privilege-ldap│ │ ├── multi-tenant.md│ │ ├── optimization.md│ │ ├── query-profile.md│ │ └── sql-interception.md│ │ └── workload-group.md│ ├── ......├── i18n│ └── zh-CN│ ├── docusaurus-plugin-content-docs│ │ ├── current│ │ ├── version-1.2│ │ ├── version-2.0│ │ ├── version-2.1│ │ ├── current.json│ │ ├── version-1.2.json│ │ ├── version-2.0.json│ │ ├── version-2.1.json│ ├── docusaurus-plugin-content-docs-community│ └── local_build_docs.sh├── src│ ├── components│ │ ├── Icons│ │ ├── More│ │ ├── PageBanner│ │ └── PageColumn│ ├── ......├── static│ ├── images│ │ ├── Bloom_filter.svg.png│ │ ├── .....│ └── js│ └── redirect.js├── versioned_docs│ ├── version-1.2│ │ ├── admin-manual│ │ ├── advanced│ │ ├── benchmark│ │ ├── data-operate│ │ ├── data-table│ │ ├── ecosystem│ │ ├── faq│ │ ├── get-starting│ │ ├── install│ │ ├── lakehouse│ │ ├── query-acceleration│ │ ├── releasenotes│ │ └── sql-manual│ └── version-2.0│ ├── admin-manual│ ├── benchmark│ ├── data-operate│ ├── db-connect│ ├── ecosystem│ ├── faq│ ├── get-starting│ ├── install│ ├── lakehouse│ ├── query│ ├── releasenotes│ ├── sql-manual│ └── table-design└── version-2.1│ ├── admin-manual│ ├── advanced│ ├── benchmark│ ├── data-operate│ ├── data-table│ ├── ecosystem│ ├── faq│ ├── get-starting│ ├── install│ ├── lakehouse│ ├── query-acceleration│ ├── releasenotes│ └── sql-manual├── versioned_sidebars│ ├── version-1.2-sidebars.json│ └── version-2.0-sidebars.json│ └── version-2.1-sidebars.json├── babel.config.js├── build.sh├── buildVersions.sh├── docusaurus.config.js├── package.json├── README.md├── sidebars.json├── sidebarsCommunity.json├── tree.out├── tsconfig.json├── versions.jsonThe following describes the directory structure of the Doris Website site so that users can easily find the corresponding directory and submit changes.
The blog directory is located at/blog. All Blog Markdown should be placed in that directory.
If you would like to share your technical insights, welcome to directly submitting a Blog PR or contactingdev@doris.apache.org.
Here is the list of files if you need to submit docs changes:
- Markdown Files: When you want to modify existing content or add new documents, you need to place them to the respective folders and both update Master branch and Version docs (2.1/2.0/1.2) .
- Sidebar Files: These files control the directory structures. When adding new files or new directory, you should also update relative path in sidebar files that ensure the new document is displayed correctly in directory. Currently, Master branch and other versions have separate sidebar files, including
sidebar.json, version-2.0-sidebars.json, and version-2.1-sidebars.json.
Please make sure to update all the necessary files accordingly when modifying existing document content, adding new documents, or adding new directory sections.
The following are the detailed steps for explaining how and where modify the docs:
Updating Latest Version (Master Branch)
1. Update content
This version is modified in the/docs directory
.├── docs│ ├── admin-manual│ ├── ......2. Update sidebar
The docs directory structure of the latest version is edited bysidebar.json.
.├── docs│ ├── admin-manua│ ├── ......├── i18n├── src├── static├── versioned_docs├── versioned_sidebars├── sidebars.jsonWhether add new docs to existing directory or new directory, you need to update the relative path of the added docs insidebar.json.
{"docs": [ {"type":"category","label":"Getting Started","items": ["get-starting/quick-start","get-starting/what-is-apache-doris" ] }, {"type":"category","label":"Install and Deploy","items": ["install/standard-deployment", {"type":"category","label":"Docker Deployment","items": ["install/construct-docker/build-docker-image","install/construct-docker/run-docker-cluster" ] }......} ] }Updating Version 2.1/2.0/1.2
1. Update content
2.1 version is modified in the
/versioned_docs/version-2.1directory2.0 version is modified in the
/versioned_docs / version-2.0directory1.2 version is modified in the
/versioned_docs / version-1.2directory
.├── blog├── community├── docs├── i18n├── versioned_docs│ ├── version-1.2│ ├── version-2.0│ ├── version-2.12. Update sidbar
The docs directory structure of the version docs is edited byversion-X.X-sidebar.json.
.├── blog├── community├── docs├── i18n├── versioned_docs├── versioned_sidebars│ ├── version-1.2-sidebars.json│ └── version-2.0-sidebars.json│ └── version-2.1-sidebars.jsonIf you want to modify the community docs, please go tocommunity/ directory.
For modifying the existing docs, please go to
community/directory.For updating community docs directory, please modify the
sidebarsCommunity.jsonto include appropriate relative path for the new document.
.├── blog├── community│ ├── design│ │ ├── spark_load.md│ │ ├── doris_storage_optimization.md│ │ ├── grouping_sets_design.md│ │ └── metadata-design.md│ ├── ......│ ......├── sidebarsCommunity.json
All images are located at/static/images.
You can display images in simple syntax:
If the image file name consists of multiple English words, they should be separated by hyphens "-".
About
Apache Doris Website
Topics
Resources
License
Code of conduct
Security policy
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Releases
Packages0
Uh oh!
There was an error while loading.Please reload this page.