Based on the work from Peter Evans
Read his work here: https://github.com/peter-evans/swagger-github-pages
- Make
<your_api_project_dir>
directory, andcd
into it.
mkdir -p <your_api_project_dir>
cd <your_api_project_dir>
- Run the
setup.sh
script in<your_api_project_dir>
.
bash -c "$(curl -fsSL https://raw.githubusercontent.com/wileymab/swagger-pages/master/setup.sh)"
- Initialize
<your_api_project_dir>
as a git working tree. (git init
) - Create the repo in
github.com
, and follow the setup for adding your github repo as your working tree remote. - Go to
Settings
for you github repo, and enablePages
for themaster
branch. - Once the pages link has been generated, you should be able to navigate to your new standalone swagger api docs.
Example @ https://github.com/wileymab/swagger-pages-test
Generated Swagger Pages link: https://wileymab.github.io/swagger-pages-test/