I'm playing around with RAML to document our API. I've found a rather simple command line app that will generate HTML from a RAML specification.
html2raml
The output is really clean and I like the style and simplicity of it, but it lacks a 'try now' functionality that can be seen in Swagger or other systems.
My question is, is it possible to write 'try now' functionality in the RAML code or is it something that is implemented by the compiler?
Thanks in advance.
It is implemented by the tool.
You can try this one, that has the try now functionality: https://anypoint.mulesoft.com
Related
This is a very noobie question. I hope I still can get some help. I normally use references for the languages I use. Like Tag and Syntax references so I know what they do. A example would be If I was doing HTML I would have this site open http://www.w3schools.com/tags/default.asp
I do this because I can't remember anything. It seems like w3school does not have dart yet so I was wondering if any other Dart coders found something similar?
If there is none what do you guys do to know all the syntaxes/tags? Do you remember everything?
Dartlang.org only has the API reference and some code samples which is good but not enough for me
https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/home
Dart cheat sheet is a concise and clearly arranged summary of the Dart language.
Try Chapter 2. A Tour of the Dart Language from the web version of Dart Up and Running.
It's concise but quite useful, and published as a single we page so it can be searched with the browser search function.
According to github/murkup's README, it's available to add comstomed markup language on Github.
https://github.com/github/markup
Markdown is really clumsy to use for simple projects. I just want a markup language which supports "bold", 'inline code', 'code blocks', 'links'. No need to add blanks to change line, just be simple like code. I think it already enough in most cases. So here's my code in CoffeeScript.
https://gist.github.com/3712310
I haven't learn Ruby yet. So I don't kown how to debug my language before I push it to Github, since there's not a detailed guide for beginner. Could anyone help me?
By the way, does Github accepts such a language?
The answer is in the README:
If your markup is in a language other than Ruby, drop a translator script in lib/github/commands which accepts input on STDIN and returns HTML on STDOUT. See rest2html for an example.
I encourage you to take another look at the other supported languages. Just because your file is in Markdown doesn't mean you have to use all of the features. Textile is a nice alternative, but so are all of the syntaxes supported by markup.
Think of tool and editor support in your language, and why users would want to use it. What does it bring to the table? What does it solve? It looks identical to Markdown, minus the features. You will likely need to sell your specialized markup language with one user in your pull request.
I've found a Wordpress plugin which provides code for all these buttons but I want to put them on my website (which doesn't run Wordpress).
Is there somewhere which provides the code or do I have to do them all separately?
I'm trying to add them to this website: Compress My Code.
There's lots of plug-ins for that available out there if you care to search.
My personal preference is the "SexyBookmarks" which look a bit like this:
And here's how you add them.
I've found this which seems to have everything I need, thanks for the other answer too though :)
For months now I've been trying to find a code syntax formatting extension that works for BlogEngine.Net. I'm not fond of the behavior of the default formatting extension, and have tried a couple of others (manoli is among them), but they always seem to interact badly with the TinyMCE editor. Does anyone know of an extension that works, or a different approach that will allow me to make code samples pretty on my blog without hacking the crap out of the HTML myself?
Thanks.
I would try using Windows Live Writer along w/ the Paste From Visual Studio plugin. One you go WLW, you'll never go back to that damn TinyMCE interface.
WLW here:
http://get.live.com/writer/overview
Plugin here:
http://gallery.live.com/liveItemDetail.aspx?li=d8835a5e-28da-4242-82eb-e1a006b083b9&l=8
Thanks, Rafe. Thanks to this post that Hanselman put up the day after I asked the question, I downloaded WLW and am now using it. As far as getting prettily formatted code, I'm using cut-and-paste from a little tool developed and available on manoli.net.
Check out SyntaxHighlighter.. Works excellent. For easy integration into BlogEngine have a look at my blog post.
Is there a utility that will generate html or css for blocks of code (.net c#) when you post it on a website?
I have seen several websites with very nicely formatted code and I dont believe they do this manually.
Google prettify -
http://code.google.com/p/google-code-prettify/
I prefer Syntax Highlighter implementations (I'm using Wordpress plugin implementation for my blog).
Advantages
It is based on JavaScript and does
not care about what you have on the
server.
Posts with this formatting display
properly on different RSS feeds and
can be copied to clipboard.
It is trivial to extend syntax
rules. I'm using that to highlight
custom operators in Boo-based DSL (see sample post)
Multiple languages are supported
out-of-the-box
(source: googlecode.com)
You can get JavaScript syntax-highlighting scripts, such as this one by Dean Edwards.
This is also a jQuery version apparently based on it which looks good.
CopySourceAsHtml is an add-in for Microsoft Visual Studio 2005 that allows you to copy source code, syntax highlighting, and line numbers as HTML.
http://copysourceashtml.codeplex.com
It's highly configurable, and works much better than the download page would make you expect! Don't know if there is something similar for VS 2008
If you don't have the ability to add the google prettifier CSS reference, this would be a better way to go, as what you get is a complete HTML with the required style. I use it all the time on our developers wiki, and loving it.
An even better solution, if you don't want to bother installing anything, is to just use the little web app I wrote called BlogTrog CodeWindow:
http://www.blogtrog.com
It's easy to use. Just paste your code and embed the results.