Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 3 months ago.
Improve this question
I'm about to write some api docs using swagger but the web ui seems very broken for me. I'm trying to set it up so I can write in any editor on my local computer and have the result automatically reload in my browser (or at least automatically rebuilt so I can refresh to see the result). I can see there are a few tools swagger codegen, swagger ui but these seem to be fairly complex tools doing a lot of stuff I don't need and I can't work out how to set them up to do what I want. I can also see there is a plugin for VS Code that does this but I would rather use vim.
If I just want something that reads a text file and builds the html every time the text file gets changed how would I set that up?
Why you don't want to go with Postman. Postman has many features including export and import the APIs. But if you don't want to use that or any other tool like swagger ui etc as you mentioned then you can build your own json file which you can use to build your html each time so that if you change anything in in json then it will reflect back in your web page.
I used this vscode plugin which gives a split screen view similar to the online editor but runs locally.
Related
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 7 years ago.
Improve this question
Is there a tool like Dredd (for API blueprint) that can be used with Swagger schema?
I would like to use such a tool to automate testing - have swagger schema files document my API, and then use such a tool to automate tests.
The tool should have the following ability:
Define the endpoint (including host and port) to run the test against
Have descriptors or meta data for each test that define which schema file to use and what example payload to use, and what is the expected response
There's a Swagger2Blueprint converter (https://github.com/apiaryio/swagger2blueprint), you could use it to setup your workflow with Dredd and Swagger files.
I'd suggest using SoapUI for doing so. You can import a swagger definition and create a number of tests automatically. See here for the source, and you can always download the application pre-built.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
I'm using Sundown on my backend to store and render markdown text. Now I would like to edit this text in a browser with some basic formatting. I'd prefer WYSIWYG but can live with a preview panel on a separate element.
But: I fear that editing on mobiles might just be something that one should avoid and fallback to basic text editing. This will be annoying to the non-techie users if we force them to learn Markdown just because they want to "Enter pretty text on my iPhone"... :-/
I've been looking around at some editor components and at the moment I'm testing CKEditor. Works fine but seems to be a bit buggy on the iPhone (at least the version I'm testing). Did not find a way to force it to only edit Markdown.. yet.
Another one is TinyMCE. Back in 2010 it seemed the same story when it came to mobile devices... just wondering if it's still the case today. It seems to work ok on my device but the layout does not seem optimized for small factor screens... sigh.
Thus:
I think that a basic editor can work on mobile devices, but I've seen that some sites disable this and gracefully fall back to standard text edits (As StackOverflow does when visting from an iPhone device)
I just need basic formatting with bold, underline, Header 1 etc and keep the format Markdown - like the SO editor
Any suggestions or comments?
tinyMCE version 4 actually works just fine on my iPhone, I've put together a small scaled down example for you on their fiddle-site:
http://fiddle.tinymce.com/Ppdaab
I highly recommend https://stackedit.io/. It converts html (or text) into markdown and doesn't require using Git. You can access it on their website or using the Chrome app. It's lightweight and completely WYSIWYG. Simply type away, it will show you a preview in markdown format. You can then save, publish, share, sync or download the file.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 4 years ago.
Improve this question
We have different forms of documentation for our desktop apps, but until now most iOS apps have been fairly self-explanatory so we've been able to get by with simple hint strings in settings etc.
But for a more complex app I'd like to be able to create a few HTML pages that look approximately like native iOS UI and are easy to maintain.
Dashcode has a browser template that seems to fit the bill, but it's terribly buggy under Lion. I could start from scratch using something like iUI, but I'm wondering if there isn't something readymade already out there that would fit the bill?
Requirements:
- One or possibly two levels of hierarchy
- Display short formatted text with images
- Preferably HTML so the documentation authors can create and format the content on their own without touching the dev side of things
Any ideas or tips would be appreciated!
I use CSS formatted HTML pages that can either be included in the project or served from the web or actually both (you can do a check so see if the app has a connection to the server and if so serve them up from there or serve them from a local resource).
I personally think the Static Cell UITableView is the ultimate way to display those help options. That and Storyboard were the two big favorites for me in iOS5.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 6 years ago.
Improve this question
I was looking for something to help me parse general meta-tags from websites similar to this github project I found for open graph data. Here's a demo app.
Basically, I'd like to be able to have a user input a URL from a news site and have it retrieve from that the Title, Desc, etc., leaving as little work possible for the user. Before I go roll my own I was wondering if there was a current project / gem that exists similar to the project above? (as it only works with open graph and not general meta-tags)
I also noticed that facebook's linter does this as well even without open graph specific tags.
I would recommend the Nokogiri gem. It is an HTML, XML, etc. parser so you can use it to parse pages on your own. The nice thing about this approach is that it affords you the most flexibility for your specific use case. You can use the gem to parse any meta and header tags as long as you can express them using XPath or CSS3 selectors.
You can also try this free (for most) Open Graph API that I built: http://www.opengraph.io/
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 3 years ago.
Improve this question
I have a legacy application that generates VRML 1.0 files. I'd like to build a WebGL-based web interface that can display these VRML files. Is there an easy way to do so?
Edit: Specified that they are VRML 1.0.
If you can get it to VRML 2.0 (VRML '97) using a tool like the above-referenced one from Parallelgraphics, you can use the Fraunhofer Institute's tools (see discussion and links to InstantReality at http://www.x3dom.org/?page_id=532) to go from VRML 2 to either X3DOM or X3D. With Firefox or Chrome and a current graphics card and driver, you've got the WebGL support needed to run X3DOM. X3DOM handles only a subset of X3D, but can be referenced straight from XHTML and CSS, or plug-ins required. It's at a much higher level and easier to deal with than dealing directly with WebGL.
As I understand it, X3D is a development from VRML, and there's a WebGL-based renderer for it called X3DOM. Converting over is unlikely to be zero-effort, but it might be easier than trying to make the jump all the way to a "native" WebGL format.
VRML can be pretty complex with lots of interactivity and it doesn't look like a ont-to-one converter is available. However, here is what you could try:
Convert your VRML file to a standard OBJ file using something like MeshConv
Import the converted file in CopperLicht (Free) or CopperCube (Not free)
You will then have some kind of conversion of your VRML file which you can fine-tune.