forked from gitea/gitea-docusaurus
HesterG
04a97d20b1
# Changes - Added [redocusaurus](https://github.com/rohit-gohri/redocusaurus) package to display swagger api with reference to [woodpecker](https://github.com/woodpecker-ci/woodpecker/tree/master/docs) - Change `sed` for swagger.json for proper version and baseurl. - Add a dropdown for different api versions. (screenshot below) - On API pages, only API version dropdown will show(hide locale dropdown, version dropdown for doc, and doc search) - Allow build CSR API pages for development so it saves building time. # Screenshots ![Screen Shot 2023-06-27 at 11.56.59](/attachments/7f43976d-f9f1-42ff-85f5-0bc84e549441) ![Screen Shot 2023-06-27 at 10.58.11](/attachments/bde25da5-b0a6-4908-9c69-c6aed41f8f59) ![Screen Shot 2023-06-21 at 12.26.26](/attachments/84a9bf5a-229b-4031-9654-3bae6cb3301a) ![Screen Shot 2023-06-19 at 16.34.33](/attachments/653b2b59-bc8a-4e6c-82f2-eb9710f55d8d) Search: ![Screen Shot 2023-06-21 at 14.49.15](/attachments/3a09bd89-36a8-4156-a2df-2d3176d3ddb1) Reviewed-on: gitea/gitea-docusaurus#32 Co-authored-by: HesterG <hestergong@gmail.com> Co-committed-by: HesterG <hestergong@gmail.com>
99 lines
3.5 KiB
Makefile
99 lines
3.5 KiB
Makefile
export NODE_OPTIONS := "--max-old-space-size=4096"
|
|
|
|
.PHONY: all
|
|
all: build
|
|
|
|
.PHONY: create_dir
|
|
create_dir:
|
|
mkdir -p .tmp docs versioned_docs awesome
|
|
|
|
.PHONY: clone_awesome
|
|
clone_awesome: create_dir
|
|
git clone --branch=main https://gitea.com/gitea/awesome-gitea.git .tmp/upstream-awesome || true
|
|
|
|
.PHONY: prepare-awesome-latest
|
|
prepare-awesome-latest: clone_awesome
|
|
cp .tmp/upstream-awesome/README.md docs/awesome.md
|
|
|
|
.PHONY: prepare-awesome\#%
|
|
prepare-awesome\#%:
|
|
cp .tmp/upstream-awesome/README.md versioned_docs/version-1.$*/awesome.md
|
|
|
|
.PHONY: clone_main
|
|
clone_main: create_dir
|
|
git clone --branch=main https://github.com/go-gitea/gitea.git .tmp/upstream-docs-latest
|
|
cur_path=`pwd`
|
|
cd .tmp/upstream-docs-latest/docs && make trans-copy
|
|
cd $(cur_path)
|
|
bash check_outdated.sh latest zh-cn
|
|
|
|
.PHONY: prepare-latest
|
|
prepare-latest: clone_main
|
|
cp -r .tmp/upstream-docs-latest/docs/static/* static/
|
|
rsync -avz --prune-empty-dirs --include '*/' --include='*.en-us.md' --exclude '*' .tmp/upstream-docs-latest/docs/content/doc/ docs/
|
|
cp .tmp/upstream-docs-latest/docs/content/page/index.en-us.md docs/intro.md
|
|
cp .tmp/upstream-docs-latest/templates/swagger/v1_json.tmpl static/swagger-latest.json
|
|
bash loop_docs.sh latest en-us
|
|
|
|
.PHONY: prepare-latest-zh-cn
|
|
prepare-latest-zh-cn:
|
|
# clone_main
|
|
# cp -r .tmp/upstream-docs-latest/docs/static/* static/
|
|
mkdir -p i18n/zh-cn/docusaurus-plugin-content-docs/current
|
|
rsync -avz --prune-empty-dirs --include '*/' --include='*.zh-cn.md' --exclude '*' .tmp/upstream-docs-latest/docs/content/doc/ i18n/zh-cn/docusaurus-plugin-content-docs/current/
|
|
cp .tmp/upstream-docs-latest/docs/content/page/index.zh-cn.md i18n/zh-cn/docusaurus-plugin-content-docs/current/intro.md
|
|
bash loop_docs.sh latest zh-cn
|
|
rm -rf .tmp/upstream-docs-latest
|
|
|
|
.PHONY: clone_\#%
|
|
clone_\#%: create_dir
|
|
git clone --branch=release/v1.$* https://github.com/go-gitea/gitea.git .tmp/upstream-docs-$*
|
|
cur_path=`pwd`
|
|
cd .tmp/upstream-docs-$*/docs && make trans-copy
|
|
cd $(cur_path)
|
|
bash check_outdated.sh $* zh-cn
|
|
|
|
.PHONY: prepare\#%
|
|
prepare\#%: clone_\#%
|
|
cp -r .tmp/upstream-docs-$*/docs/static/* static/
|
|
rsync -a --prune-empty-dirs --include '*/' --include='*.en-us.md' --exclude '*' .tmp/upstream-docs-$*/docs/content/doc/ versioned_docs/version-1.$*/
|
|
cp .tmp/upstream-docs-$*/docs/content/page/index.en-us.md versioned_docs/version-1.$*/intro.md
|
|
cp .tmp/upstream-docs-$*/templates/swagger/v1_json.tmpl static/swagger-$*.json
|
|
bash loop_docs.sh $* en-us
|
|
|
|
.PHONY: prepare-zh-cn\#%
|
|
prepare-zh-cn\#%:
|
|
# clone_\#%
|
|
# cp -r .tmp/upstream-docs-$*/docs/static/* static/
|
|
mkdir -p i18n/zh-cn/docusaurus-plugin-content-docs/version-1.$*
|
|
rsync -avz --prune-empty-dirs --include '*/' --include='*.zh-cn.md' --exclude '*' .tmp/upstream-docs-$*/docs/content/doc/ i18n/zh-cn/docusaurus-plugin-content-docs/version-1.$*/
|
|
cp .tmp/upstream-docs-$*/docs/content/page/index.zh-cn.md i18n/zh-cn/docusaurus-plugin-content-docs/version-1.$*/intro.md
|
|
bash loop_docs.sh $* zh-cn
|
|
rm -rf .tmp/upstream-docs-$*
|
|
|
|
.PHONY: install
|
|
install:
|
|
npm install
|
|
|
|
.PHONY: prepare-docs
|
|
prepare-docs: install prepare-latest prepare\#20 prepare\#19 prepare-latest-zh-cn prepare-zh-cn\#20 prepare-zh-cn\#19 prepare-awesome-latest prepare-awesome\#19 prepare-awesome\#20
|
|
|
|
.PHONY: build
|
|
build:
|
|
npm ci
|
|
npm run build
|
|
|
|
.PHONY: serve
|
|
serve: prepare-docs
|
|
npm run start
|
|
|
|
.PHONY: clean
|
|
clean:
|
|
rm -rf .tmp
|
|
rm -rf docs
|
|
rm -rf versioned_docs/
|
|
rm -rf static/_*
|
|
rm -rf static/swagger-latest.json
|
|
rm -rf static/swagger-19.json
|
|
rm -rf static/swagger-20.json
|