v5 site upgrade

[PeachScript]

ref: #34087

Preparation for Contribute

• Base branch: v5-site-upgrade
• Doc framework: dumi 2.0 (v5 target), Bisheng (v4 used)
• dumi 2.0 theme system: [RFC] dumi 2.0 theme system umijs/dumi#1180
• Tasks targets:
  1. Migrate Bisheng to dumi 2.0
  2. Rewrite theme according to v5 site design
• ‼️ Tasks explanations:
  1. from links to the legacy code, to links to the target file that should to be programmed
  2. Design sub task means that the Code sub task can be start after design ready

Contribution steps

1. Clone repo and checkout a self branch from the base branch
2. npm i
3. npm start & open http://localhost:8000
4. Coding & testing
5. Push & create a pull request to the base branch

Tasks for next preview (P0)

Layout

• Migrate ConfigProvider, Dynamic Theme & etc. to GlobalLayout @MadCcc
• Migrate Layout to DocLayout @PeachScript
• Migrate Header @MadCcc
  • 
  • Design
  • Code (from -> to)
    • Navbar
    • Search bar
    • GitHub link
    • RTL button
    • Language switch
    • ...
• Migrate Sidebar @MadCcc
  • 
  • Design
  • Code (from -> to)
    • Sticky
    • Menu Group & Menu Item
    • Collapsible (only for design doc)
    • ...
• Migrate Footer @MadCcc
  • 
  • Design
  • Code (from -> to)

Custom pages

• Migrate /index page @zombieJ
  • Design
  • Code (from -> to)

Tasks for release (P1)

Layout

• Migrate Content
  • 
  • Design
  • Code (from -> to)
    • Title & edit link
    • TOC
    • Contributors list
    • Prev & next page
    • ...

Custom Components

• Migrate Previewer
  • 
  • Basic migrate @PeachScript
  • Refactor with dumi way (remove the compatibility HOC)
• Create DemoWrapper (from -> to) @zqran
  • 
  • Expand source code for all previewer
  • Display debug demo
• Create IconSearch (from -> to) @TrickyPi
  • 
• [PENDING] Components that depend on the new markdown data structure ready:
  • New data structure to describe markdown content for ResourceCard, APITable & etc. @zombieJ @MadCcc
  • Create ResouceCard
    • 
    • Design
    • Code
  • Create #38180
    • 
    • Design
    • Code

Custom pages

• Migrate /components/overview page (from -> to) @li-jia-nan feat: v5 site overview page #38131
• Migrate /changelog page (from -> to) @li-jia-nan feat: v5 site change-log page #38137 feat: v5 site change-log page #38162
• Migrate 404 page (from -> to) @zqran feat: Migrate 404 page #38118

Compile-time plugin

• rehypeAntd plugin:
  • Transform demo tsx to jsx via https://github.com/umijs/sylvanas (from -> to)
  • Compile markdown content to the new data structure (depends on data structure task completion) @PeachScript
• dumi plugin:
  • Register tab ui to display design/code to a single page (depends on dumi tab solution ready) @PeachScript

[TrickyPi]

Contribution steps

1. Clone repo and checkout a self branch from the base branch
2. npm i
3. npm run start:dumi & open http://localhost:8000
4. Coding & testing
5. Push & create a pull request to the base branch

第三步的npm run start:dumi应该改成npm run start了吧