I'd like to add some descriptive comments to my PWA's app.webmanifest file. I know that JSON doesn't typically support comments, but I thought that maybe the file wasn't following strict JSON, (since it isn't saved as .json).
The MDN docs didn't seem to mention anything.
Related
I've looked around and can't find where the conventions for formatting the description field in a nuspec file are documented. I can see that you can at least add paragraphs but I don't know how it is done and would like to know if there is anything else that can be done.
It's plain text, so paragraphs/tabs etc. are all you get at the moment. It looks like there is a feature request to add support for arbitrary syntax formatting by supporting embedded XML tags describing the parser, or at least standardizing on supporting markdown, but no movement on them yet.
I am working on a project that is heavily documented with doxygen.
In a UI I have a list of all the classes available - I would like to be able to open the right documentation page of the class I select. In order to do that I need an easy to read link, so I can dynamically build it and run it.
Is it there any way I can control the generated link of the html file? Because the ones I have right now are impossible do be built dynamically.
You could use Doxygen's tag file mechanism for that (see GENERATE_TAGFILE in the config file).
A tag file is a reasonably easy to understand and parse XML file that basically lists all symbols in your project, with for each symbol the corresponding (relative) URL to the documentation.
So you could parse the tag file from your UI to resolve the links to the doxygen generated documentation in a robust way.
I am trying to find a MediaWiki bot or extension that would do the following:
I sometimes copy external content to MediaWiki to display it in proper context and to make it searchable. That is not very DRY.
I would like to keep a live link to the original content using a special tag and have a bot update the MediaWiki page if the original content changes.
For instance, the snippet could be a configuration file in Subversion that I want to reference in documentation. I would like to do something like:
<external-content
url="http://svn/config.txt"
start="#begin snippet"
end="#end snippet">
</external-content>
The MediaWiki bot would download http://svn/config.txt, retain everything between the #begin snippet and #end snippet comments, and paste the result right between the external-content tags.
This way I can be sure that as I change the config.txt, my MediaWiki documentation stays in sync.
There are numerous other uses. I am not looking only into referencing Subversion content, there are many other web-based systems with data I would like to integrate in this manner.
Does anyone know of a bot that would do this?
You could probably do this with a MediaWiki parser tag extension. In fact, the "Include" extension seems to do something very much like what you're asking for.
I'm working on a mobile site for the iphone. I've added a cache manifest and loaded it with a list of resources needed for offline capability. The manifest file has the correct content type. You can view the manifest file in the header of this page:
http://www.rvddps.com/apps/sixshot/booking.html
I had a bunch of links to pages but due to my user level i'm only allowed to post one link. You can see the manifest file there and the source code of the page i'm trying to cache.
I've set the correct MIME type on the server, but the cache only seems to work occasionally.. not all the time. I've tried following apples' official caching guidelines as well.
Can anyone point out where i'm going wrong?
Thanks
Daniel
I looked at the manifest file and found 'Â' characters in some of the blank lines. What text editor are you using? Make sure you use the proper encoding and line ending types.
The view file macro allows embedding documents (.ppt, .pdf, etc) on a Confluence wiki page. Limitation is, documents must be on attachments.
So question, is there a way to load dynamically a file located into an SCM's deposit?
P.S. Current SCM: Perforce.
UPDATE: As I see, there is no official Perforce plugin.
You may of course include a link to that file, if Perforce provides a way to link items. We use that a lot, to include content that is stored in Subversion, and document the standing, the usage, ... in Confluence then. The user has to click on that link to get that file, but I think it is necessary anyway, because your authorization rules are not known to Confluence.