Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(static-doc): static documentation generation #60

Merged
merged 20 commits into from
Dec 27, 2022
Merged

Conversation

uguy
Copy link
Member

@uguy uguy commented Sep 16, 2022

Generate static documentation that could be more search engine friendly.

Closes DEV-45

package.json Outdated
"clean": "rm -rf dist/*",
"yaml": "copyfiles -u 2 docs/images/* dist/static/images/ && redocly bundle -o dist/openapi.yaml -f",
"build": "npm run clean && npm run yaml",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@uguy you remove the build goal, but it IS CALLED by the GH Action!

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did it

"yaml": "copyfiles -u 2 docs/images/* dist/bonita-openapi-$npm_package_version/images/ && redocly bundle -o dist/openapi.yaml -f",
"postman": "node_modules/.bin/openapi2postmanv2 -s dist/openapi.yaml -o dist/postman.json -p",
"static": "redoc-cli build ./dist/openapi.yaml -t docs/index.html.hbs --cdn -o ./dist/bonita-openapi-$npm_package_version/index.html && copyfiles -u 1 dist/openapi.yaml dist/bonita-openapi-$npm_package_version && copyfiles -u 1 dist/postman.json dist/bonita-openapi-$npm_package_version",
"package": "npm run clean && npm run test && npm run yaml && npm run postman && npm run static && cd dist/bonita-openapi-$npm_package_version && zip -r ../bonita-openapi-$npm_package_version.zip *"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@uguy you modify the deliverable assets, but not in the release.yml
Please do.

@uguy uguy merged commit 018cbb6 into master Dec 27, 2022
@uguy uguy deleted the feat/static_doc_gen branch December 27, 2022 09:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants