English | 中文

This is the repository containing all the source code of http://streampark.apache.org. This guide will guide you how to contribute to the Apache StreamPark™ (Incubating) website.

dev is the default branch. For all modifications, please fork first, and then check out a new branch to proceed.

This website is compiled using Node.js (version >=16.14 <=18), using Docusaurus (2.4.3) framework components.

To download and preview the website:

git clone https://github.com/apache/incubator-streampark-website.git streampark-website
cd streampark-website
npm install
npm run start

It'll open http://localhost:3000 for you to view the English preview of the site. Instead, run npm run start-zh to preview the Chinese version.

To generate static website resource files, run npm run build. The static resources of the build are in the build directory.

|-- community
|-- docs     // The next version of the document that will be released soon
|-- download
|-- faq      // Q&A
|-- i18n
|   -- zh-CN  //Internationalized Chinese
|       |-- code.json
|       |-- docusaurus-plugin-content-docs
|       |-- docusaurus-plugin-content-docs-community
|       |-- docusaurus-plugin-content-docs-download
|       |-- docusaurus-plugin-content-docs-faq
|        -- docusaurus-theme-classic
|-- resource  // Original project files for architecture/timing diagram/flow chart, etc.
|-- src
|   |-- components
|   |-- css
|   |-- js
|   |-- pages
|   |   |-- home
|   |   |-- index.jsx
|   |   |-- team
|   |   |-- user
|   |    -- versions
|   |-- styles
|-- static // Picture static resource
|   |-- doc  // document picture
|        |-- image //document common picture
|        |-- image_en //English document picture
|        |-- image_zh //Chinese document picture
|   |-- user // users picture
|   |-- home // homepage picture
|   |-- image  // common picture
|-- docusaurus.config.js

Use all lowercase, separated by underscores. If there is a plural structure, use plural nomenclature, and do not use plural abbreviations:

• Positive example: scripts / styles / components / images / utils / layouts / demo_styles / demo-scripts / img / doc
• Counter example: script / style / demoStyles / imgs / docs

All lowercase, separated by a dash:

• Positive example: render-dom.js / signup.css / index.html / company-logo.png
• Counter example: renderDom.js / UserManagement.html

Image resources are unified under static/{module name}; CSS and other style files are placed in the src/css directory.

Except for the homepage, team, user, Docs>All Version module page, all other pages can be directly jumped to the corresponding GitHub resource modification page through the 'Edit this page' button at the bottom.

Visit the page http://streampark.apache.org; located in src/pages/home:

├─home
│ languages.json // Home page Chinese and English configuration
│ index.less     // homepage style

Visit the page http://streampark.apache.org/team; located in src/pages/team:

├─team
│ languages.json
│ index.js
│ index.less

Visit the page http://streampark.apache.org/user; located in src/pages/user:

├─user
│ data.json
│ images.json
│ index.js
│ index.less
│ languages.json