Merge pdf (#2751)

* Update deploy.yaml

* Update pdf.yml

* Create conditional_pdf.py

* Update mkdocs.yml

* WIP Update deploy.yaml

* Update database_edition.yml

* Update deploy.yaml

* Update deploy.yaml

* Update deploy.yaml

* Update deploy.yaml

* Update deploy.yaml

* Delete auto_release.py

---------

Co-authored-by: min.wu <50101159+whitewum@users.noreply.github.com>

.github/workflows/deploy.yaml

@@ -1,11 +1,11 @@
 name: Publish docs via GitHub Pages
 env:
- ACTIONTEST: community
+ ACTIONTEST: master
 # branch name, like master, 2.4
 on:
  push:
  branches: # hard code branch name
- - community
+ - master
 
 jobs:
  prepare:
@@ -27,7 +27,7 @@ jobs:
  id: set-matrix
  run: |
  import yaml, os, json
- with open('database_edition.yml', 'r') as file:
+ with open('./database_edition.yml', 'r') as file:
  mkdocs = yaml.safe_load(file)
  database_edition = mkdocs.get('database_edition', '')
  print(f"database_edition: {database_edition}") # Print the variable for debugging
@@ -61,27 +61,29 @@ jobs:
 
  - name : prepare
  run: sh ./prepare.sh
-
+ # if 'both', set each file 'community' and 'enterprise' seperately.
  - name: Update database_edition.yml
  run: |
- import yaml
- with open('database_edition.yml', 'r') as file:
- mkdocs = yaml.safe_load(file)
- database_edition = mkdocs.get('database_edition', '')
+ import yaml 
+ with open('./database_edition.yml', 'r') as file:
+ content = yaml.safe_load(file)
+ content['database_edition'] = f"${{ matrix.database_edition }}"
+ with open('./database_edition.yml', 'w') as file:
+ yaml.dump(content, file) 
  shell: python
-
+ 
  - name: Git Config
  run: git config user.name whitewum && git config user.email min.wu@vesoft.com
 
  - name: save tmp files
  run: |
- cp -f *.json /tmp/
- cp -f *.yml /tmp/
+ cp -f *versions.json /tmp/ # f"${{ matrix.database_edition }}"_versions.json
  ls /tmp/ -ltr
  - name: mike 
  run: |
  python ./scripts/conditional_render.py
  python ./scripts/conditional_yml.py
+ python ./scripts/conditional_pdf.py
  git fetch origin gh-pages --depth=1 # fix mike's CI update
  mike deploy ${{ env.ACTIONTEST }} -p --rebase
  mike list
@@ -94,10 +96,8 @@ jobs:
  run: | 
  import yaml, json
  new_content = {"version": "${{ env.ACTIONTEST }}", "title": "${{ env.ACTIONTEST }}", "aliases": []}
- with open('/tmp/database_edition.yml', 'r') as file:
- mkdocs = yaml.safe_load(file)
- database_edition = mkdocs.get('database_edition', '')
- filename = "/tmp/" + database_edition + "_versions.json"
+ # the only place read from /tmp/
+ filename = "/tmp/" + f"${{ matrix.database_edition }}" + "_versions.json"
  with open(filename, 'r') as infile:
  json_data = json.load(infile)
  found = False
@@ -107,7 +107,7 @@ jobs:
  break
  if not found:
  json_data.append(new_content)
- with open('versions.json', 'w') as outfile:
+ with open('./versions.json', 'w') as outfile:
  json.dump(json_data, outfile, indent=2)
  shell: python 
  - name: Compress

database_edition.yml

@@ -1 +1,5 @@
-database_edition: community
+database_edition: both
+# Copy from the folowing words. Not write the word by your self
+# community
+# enterprise
+# both

mkdocs.yml

@@ -131,17 +131,16 @@ plugins:
 # Exclude files with regular expressions (regexes)
 # regex:
 # - '.*\.(tmp|bin|tar)$'
-
-# modify when release: 
-# - with-pdf:
-# copyright: 2023 vesoft Inc.
-# cover_subtitle: master
-# author: 吴敏，梁振亚，黄凤仙，李泓臻
-# cover: true
-# back_cover: true
-# cover_logo: 'https://cloud-cdn.nebula-graph.com.cn/nebula-for-pdf.png'
-# output_path: pdf/NebulaGraph-CN.pdf
-
+# nav.pdf.begin
+ - with-pdf:
+ copyright: 2023 vesoft Inc.
+ cover_subtitle: master
+ author: 吴敏，梁振亚，黄凤仙，李泓臻
+ cover: true
+ back_cover: true
+ cover_logo: 'https://cloud-cdn.nebula-graph.com.cn/nebula-for-pdf.png'
+ output_path: pdf/NebulaGraph-CN.pdf
+# nav.pdf.end
 extra_javascript:
  - js/version-select.js 
  - js/config.js
@@ -893,5 +892,6 @@ nav:
  - 年表: 20.appendix/history.md
  - 思维导图: 20.appendix/mind-map.md
  - 错误码: 20.appendix/error-code.md
-
-# - PDF: ./pdf/NebulaGraph-CN.pdf
+# nav.pdf.begin
+ - PDF: ./pdf/NebulaGraph-CN.pdf
+# nav.pdf.end

pdf.yml

@@ -1,12 +1,2 @@
-# modify when release: 
- - PDF: ./pdf/NebulaGraph-CN.pdf
-
-plugins:
- - with-pdf:
- copyright: 2023 vesoft Inc.
- cover_subtitle: master
- author: 吴敏，周瑶，梁振亚，黄凤仙
- cover: true
- back_cover: true
- cover_logo: 'https://cloud-cdn.nebula-graph.com.cn/nebula-for-pdf.png'
- output_path: pdf/NebulaGraph-CN.pdf
+withpdf: False
+# True or False. case sensitive

scripts/conditional_pdf.py

@@ -0,0 +1,28 @@
+import re
+import yaml
+
+def process_mkdocs_yml(mkdocs_yml_path, withpdf):
+ with open(mkdocs_yml_path, 'r', encoding='utf-8') as f:
+ content = f.read()
+ if withpdf == True:
+ content = re.sub(
+ r'#\s*nav\.pdf\.begin(.*?)#\s*nav\.pdf\.end', 
+ '\\1', content, flags=re.DOTALL)
+ elif withpdf == False:
+ print("remove pdf")
+ content = re.sub(
+ r'#\s*nav\.pdf\.begin(.*?)#\s*nav\.pdf\.end', 
+ '', content, flags=re.DOTALL)
+ with open(mkdocs_yml_path, 'w', encoding='utf-8') as f:
+ f.write(content)
+ print(content)
+
+if __name__ == '__main__':
+ pdf_yml_path = 'pdf.yml'
+ with open(pdf_yml_path, 'r', encoding='utf-8') as f:
+ config = yaml.safe_load(f)
+ withpdf = config.get("withpdf", "")
+ print(withpdf)
+ if (withpdf != True) and (withpdf != False):
+ raise ValueError("Invalid value for pdf parameter: {}".format(withpdf))
+ process_mkdocs_yml('mkdocs.yml', withpdf)