Springboot + springfox + swagger2 + swagger-ui - swagger

How can i access the generated swagger-ui.html ? Or index.html I cant seem to find this file in my project. Aghhhh!

I ended up pulling the swagger-ui dist files from git
https://github.com/swagger-api/swagger-ui/tree/master/dist
I placed them inside public directory and modified swagger-ui.html

For the library setup which you have mentioned, the following will be the URL to access the UI -
PROTOCOL://HOST:PORT/CONTEXT_NAME/swagger-ui.html
Eg: http://localhost:8083/xms/swagger-ui.html

Related

setting up swagger 3 or OpenAPI in a gradle springboot api

Swagger 3 ? or Open API ..? 3? not sure what they're calling it. There doesn't seem to be a good or easy setup.
I'm looking to add it to my java project
I don't mind manually filling out the config for my controllers and in fact do not want it dynamically config'd
and I don't want a lot of extra fluff with it.
Their github hosts a number of different files and I'm not sure what I do and don't need.
The setup at:
https://github.com/swagger-api/swagger-ui/blob/master/docs/development/setting-up.md
I've run through the setup commands and started locally which returns 2 js files, 1 css, and the swagger.json.
Does anyone know if there's a gradle or maven import / line that I can just plop into my build and get the code I need?
Has anyone setup swagger 3 with just the bare minimum to host the ui page with their controller on a java/springboot app?
any help welcome.
git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui
npm install
npm run dev

MkDocs does not work properly with custom URL path

Currently I'm using mkdocs, version 1.0.3 from /usr/local/lib/python2.7/dist-packages/mkdocs (Python 2.7)
With mkdocs-material-3.0.4 theme.
I generated a static site using command mkdocs build and trying to deploy it. All site files are generated and use relative paths to static content (for ex. js/something.js).
The problem is that I need to use it from URL https://internal.domain.com/docs/. But I can not find the configuration to specify a relative path to generate paths with prefix (for ex. docs/js/something.js).
On the server side, I'm using k8s + ingress with rewrite rule (from https://internal.domain.com/docs/ to `https://docs_service/).
Any suggestions on how to fix it?

How to host Jazzy documentation on Bitbucket?

I have generated documents for my application with Jazzy.
now I want to add a link to index.html file which is generated by Jazzy and it's the main page of the documentation in README.md file.
the problem is when I create a link addressing index.html file it only shows me the source file. I want it to be rendered as website.
Is there anyway through this?
P.S. my bitbucket repository is a private one. and we're running a local application of Bitbucket in our local network.
Have you had a look at the documentation (https://confluence.atlassian.com/bitbucket/publishing-a-website-on-bitbucket-cloud-221449776.html)?

What is the default (official?) Bower registry URL?

What is the main Bower registry URL?
We're trying to set up Bower to use our registry first, then the "official" Bower registry second.
We've created our own little Bower registry based on the endpoints exposed in [bower/registry]1. Works great.
Based on this doc, it looks like we need to create a .bowerrc file with an array of registries like
{
"registry": {
"search": [
"http://myCustomRegistry/api",
"theMainBowerRegistry"
]
}
}
Works fine for use my custom registry, but I can't find the URL for the main Bower registry. Anyone?
The default registry URL is => https://bower.herokuapp.com
Now it is https://registry.bower.io
https://twitter.com/bower/status/908359136601133056
See the explanation https://gist.github.com/sheerun/c04d856a7a368bad2896ff0c4958cb00
The default registry as of now is https://raw.githubusercontent.com/bower/components/1.0.0 for anyone looking in 2017. Entering this into my .bowerrc file solved my ECONNRESET errors. Bower moved away from the herokuapp repository it was using to Github.
The link to Bower's link on Twitter describing this move is linked below.
https://twitter.com/bower/status/796046017133211648
Actually, it's just https://bower.herokuapp.com. /packages is part of the REST API routes, which would create redundant URL segments in your Bower requests (e.g. https://bower.herokuapp.com/packages/search/bootstrap`).

How to configure symfony project in local server?

I am beginner for symfony. I have to configure the already developed project that is built using symfony. I changed the database information but when browse localhost/myproject/web there is nothing displayed. What can i do to configure the project in local server. I have created the database as well. Hope to get help. Thanks ..........
you need to point apache to the web folder in your symfony project. or if your project reside inside apache web root you could use:
http://localhost/myproject/web/index.php but that won't show any errors. insted of that you could use:
http://localhost/myproject/web/frontend_dev.php where frontend is the name of front controler ( this file is in web/ folder).
and if then you don't get any output look into your apache server error log to find why project isn't working.
few resolves:
when in symfony project root execute this in command prompt:
php symfony cache:clear
php symfony fix-perms
and then try url above.
more info here

Resources