在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称:E96/swagger2slate开源软件地址:https://github.com/E96/swagger2slate开源编程语言:PHP 70.8%开源软件介绍:How to create html docs using swagger
1. Document your php api
2. Generate html docs and publish to githubRequirements
StepsGet slate in your repository git clone --depth 1 [email protected]:{your-name}/{your-repository} {your-repository}-docs # create folder to store docs
cd {your-repository}-docs
git remote add slate [email protected]:tripit/slate.git # add slate origin to pull from
git fetch slate
git checkout --orphan slate slate/master # create slate branch with slate/master contents
git commit -m "first slate commit" Prepare slate bundle install --path vendor/bundle
echo -e "\nvendor/" >> .gitignore Download swagger2slate.phar to current directory and set execution rights to file chmod +x swagger2slate.phar
echo -e "\nswagger2slate.phar" >> .gitignore Generate slate markdown ./swagger2slate.phar convert ../{your-repository}/swagger.json -o source/index.md Preview docs bundle exec middleman server Commit changes git add -u
git commit -m "api docs update" Publish docs bundle exec rake publish Check out your doc: http://{your-name}.github.io/{your-repository}/ Resources
|
2023-10-27
2022-08-15
2022-08-17
2022-09-23
2022-08-13
请发表评论