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
What's an advisable way of documenting and sharing APIs (e.g. HTTP web-services)?
The requirements are:
A Wiki type system in which anyone can edit any page.
An easy way to write an API spec so that the styling/formatting is applied automatically, rather than having to manually add the styling for each individual page.
I would use Wordpress, except that it's not really a Wiki system; it's more of a blog engine. I want a nice, clean, structured hierarchy of pages, and the ability to click and edit instantly.
I tried Google Sites, but this also seems to be unsuitable, because it doesn't allow me to create a consistent style for APIs. The only control I have over styling is "themes", which change the look & feel of the whole site, and aren't specific enough.
I found a hosted solution here, but at $499 p/year I'm sure we can do better.
Any suggestions?
Many projects use trac. Here is an example of a project that uses it http://djangobb.org/wiki
Trac integrates together wiki, issue tracking and source control.
Might consider using something like doxygen to generate an inital snapshot and then just wikify that.
A similar question was posted here also: Wiki solution for APIs documentations?
and I suggested using MindTouch
**jonathan, just saw your comment about trac adding too much complexity. you'll likely find the same with MindTouch, but that's because you're asking for a solution to a specific problem, and the suitable tools available offer much more capabilities (ie complexities)
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 6 years ago.
Improve this question
Does anyone know some site where I can find information about autonomy??
I'm looking after code samples, architecture posts, and things like that, both about
autonomy IDOL search engine
autonomy interwoven content management server
side note:
I cannot understand why there're so many barriers to access theese product's developer resources. I thought that HP would change autonomy's policy about this but It stills the same: there's absolutely NO access to libraries, code samples, etc... you're forced to have a partner account...
If I could I'd move to opener alternatives... but it's not completly in my hand ;-(
There is little public information available about Autonomy's products.
The best way forward is to build your own network of people who know the product and have had experience with implementations.
The information that is shipped with the product can also help. Specifically regarding the Autonomy IDOL server and the calls you can make - some resources
The IDOL Administrator manual: Probably the most complete document available. It will help you understand the components which make up an IDOL architecture. However, it will not go into too much detail on complex architectures.
The Online Help: (http://:/a=help) Most components have an online help which documents all the calls and parameters.
The GRL: (http://:/a=grl) Gives you the most recent commands sent to a component. The best way to 'reverse engineer' how to components are interacting with each other.
I found that most active discussions regarding Autonomy's product suite can be found here.
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
On a few questions this package was recommended to provide Django with OpenAuth capabilities.
I'm new to Django and as one of my first projects, I'm trying to replicate StackOverflow's login and registration mechanisms. the only two documents that relate to the usability and installation of the package are the README and openid.txt files. edit I forgot to mention the example in their code base /endedit
I implemented what the files and example implemented, but so far I still feel lost in terms of actually understanding how the mechanism works and how to build a site with openauth-id integration.
The questions I have involve:
Best practice way to include multiple openID providers
Proper way to connect the to the Django-user models
Handling any security, privacy, etc issues that may arise
I have put up an example of using django-openid-auth with openid-selector(http://code.google.com/p/openid-selector/) for a nice UI on github. See if this helps.
https://github.com/rajasaur/openid_userprofiles
If something is not clear from the examples, please ask and Id be more than happy to help
Imho:
You need to include each ID provider in a separate Authentication backend.
Bast practice is also to use build in User model.
Look for example plugin that provides multiple authentication providers
django-social_auth at github.
Hope that will help...
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 8 years ago.
Improve this question
Hi, I want to develop a site with the features similar to SharePoint but without using any SharePoint services.
Please advise me which are the tools I have to use to achieve this.
The alternative should be free and customizable.
Thanks.
If your question is: What is an alternative to sharepoint? then one answer would be "alfresco". Although I'm not a fan of Alfresco as a user, it has many features similar to sharepoint: different accessing methods for shared files (WebDAV, HTTP, FTP, SMB), authorization groups and file versioning / history.
Of course it lacks the tight office integration of Sharepoint.
Edit: I'm not a fan of Sharepoint either.
Depends on what you want to with SharePoint. If you are only using 1 functionality you probably have tons of alternatives. (Wordpress, wikipedia, Drupal,..). All with their own pro's and cons.
If you want the complete package. Collaboration , search, publishing, wiki, blog, office integration, etc... The choices are limited. I'm not a great fan of DotNetNuke but it's one possibility. More in the Java camp you find Alfresco.
Have a look here,
https://stackoverflow.com/questions/1096392/any-good-alternative-for-sharepoint-ofcourse-opensource
And there are some alternatives in this thread as well Open Source SharePoint?
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 2 years ago.
Improve this question
Anyone have a recommendation for a tagging system in Django? django-tagging seems to be able to do everything short of cooking and vacuuming for you, but it hasn't been updated in more than a year. django-taggit looks simpler but equally as useful, and is quite active, at least recently.
However, neither of these apps seem to feature a tag cloud. I mean a real tag cloud, complete with the HTML and the styling and all that. Not a tag by model (which is a feature in django-tagging, pretty neat), or anything like that. Just a straight up tag cloud.
Your suggestions are highly appreciated. Thanks!
It's worth referring to djangopackages for these sorts of questions; http://djangopackages.com/grids/g/tagging/
You can see that you mentioned the two most popular with the others being hardly counted.
Personally I choose django-taggit. It's simpler, maintained by Django core devs and it has more recently been updated. It's also reassuring that the tox.ini in the django-taggit repository shows its tested against all the relevant python versions.
For me, django-tagging was bloated with more features than I would need but I understand they could be useful in some casses.
if tag cloud is what you concern, you can try django-taggit combined with django-taggit-templatetags. follow the instruction in the document in the second link, it's easy to implement your own tag cloud with few lines of template. hope this helps.
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 8 years ago.
Improve this question
My research group uses a Wordpress blog. Frequently I want post snippets or even entire short programs I've been working on to it, with most of my code being written in C/C++ or scripting languages (Bash, TCL, etc).
I figure that there have to be some good extensions to Wordpress to colorify code since so many people use it. I'm looking for something similar to StackOverflow's colorizing system, though I realize it may not be quite as robust!
Can you point me to some of your favorites/the ones you think are most reliable?
Thanks in advance!
This was the first I investigated when I started a Wordpress blog. You can use Wordpress' sourcecode shortcode, as exemplified here. It requires JavaScript on the client side (otherwise it renders as just preformatted text).
Cheers & hth.,
GeSHi is a good backend for highlighting lots of different languages. There are Wordpress plugins that support it, but I don't have a specific recommendation. (I use GeSHi for our wiki.)
You might also consider Pastie or Gist as a way to share snippets.