Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
Questions asking us to recommend or find a tool, library or favorite off-site resource are off-topic for Stack Overflow as they tend to attract opinionated answers and spam. Instead, describe the problem and what has been done so far to solve it.
Closed 9 years ago.
Improve this question
Any free alternative to Robohelp? Prefer open source
Need some sort of online help authoring tool for an open source project.
Check out this list of free help authoring tools, bound to be something useful there.
Just remembered: depending on what you want to do, you can use doxygen (www.doxygen.org) or the free help tool from http://www.vizacc.com/.
I like Sphinx.
You write your documentation using a plain text markup format, reStructuredText.
Sphinx can create HTML, Windows HTML help and PDF (via Latex).
I have created end-user documentation for two projects using Sphinx, and have also used it to document a couple of Python packages (Sphinx has a lot of features around extracting documentation from Python modules, it was originally created to write the Python documentation).
It is very easy to get started, and you get professional-looking documentation with a minimal effort.
If you are used to the WYSIWYG way of text editing, using a plain-text markup format might take some getting used to. But I believe it will be worth the effort.
I also have some experience with DocBook (one of the end-user documentation projects mentioned was a DocBook-to-Sphinx migration). I prefer Sphinx over Docbook: Plain text is more pleasant to work with than XML, Sphinx has a simpler toolchain.
See also:
List of projects using Sphinx.
PDF example
Are you trying to make just CHM or other output formats too?
Take a look at DocBook. You can make (from one source file) pdf, html and chm - and some others, too. I've used it in the past but it's not very easy or convenient to use. If you only want to output chm (and need to use a free solution), see if you can get away with using the htmlhelp workshop (http://www.microsoft.com/downloads/details.aspx?familyid=00535334-c8a6-452f-9aa0-d597d16580cc&displaylang=en).
If you are trying to build .chm based help, try chm-build
Related
Closed. This question is opinion-based. It is not currently accepting answers.
Want to improve this question? Update the question so it can be answered with facts and citations by editing this post.
Closed 5 years ago.
Improve this question
I am building an html resume (with bootstrap tabs) but want to break the sections into separate parts for easy editing and repurposing.
For example, have the work experience data in one file, have education in another and link them to a tabbed html page, but also have the option to export to a docx or pdf. Have skills appear on the html version but not on the pdf export.
What would be the best architecture design to use? Would JSON be good or should I use PHP includes.
What about xml? or should I just maek it a mysql database and use PHP to pull that data (this seems like overkill for less than 1,000 words).
I would argue any of these will be an overkill for a small project. So I'd go placing it all in one html file.
If you want to automatically generate pdf or docs it's no more a html resume. So I won't answer generating part of the question.
As for html management you can use templating language, e.g. Nunjucks or Pug
It will allow you to include html files one in another; the downside is you'll have to setup a build tool like Gulp for this (which will require some basic Javascript knowledge and time).
Something which you need to consider is the format which you would be handing into potential employers.
If you are hoping to hand in a web page, you would probably want to "render" it and not hand in a piece of functioning code. The reason for this, is if the employer/recruiter is unable to open or correctly read the file, this will decrease your chances of getting the job dramatically. Not to mention many large companies use bots which read CV's for you, See this article which explains that matter all to you.
You would also want to consider what some companies/recruiters may think when they see CV.html in their email inbox. Some will think its a really smart and creative idea, others may think it is an incompatible file with their computer and may never open it. Leaving instructions on how to open the document may take time which the employer doesn't have.
I'm not saying its a ludicrous idea, I'm saying you need to properly plan it out. Personally, I would keep an online copy on my website, but I would also have an additional copy (Word document or PDF) which could be downloaded and accessed by those bots which I mentioned early.
In programming there are many ways to do the same thing, and it is entirely up to you and your abilities to find what is best.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
Questions asking us to recommend or find a tool, library or favorite off-site resource are off-topic for Stack Overflow as they tend to attract opinionated answers and spam. Instead, describe the problem and what has been done so far to solve it.
Closed 8 years ago.
Improve this question
I'm trying to retrieve a couple of webpages so that I can manipulate their information. I am looking for what are the best tools and packages for doing this. Preferably, I would appreciate to use Perl for parsing the tables, but I would be fine with using MySQL too, though I would have to learn it.
(I believe they are HTML tables, despite the page being coded in Java?).
I am not asking for any code, but for your opinion, tips and suggestions on how I can accomplish this. My intentions are, for now, to just parse the tables, merge them, and build a single table that has the information from both sites in different columns. This general table would only need to be updated once a day at most.
The tables can be found in here, please scroll down and in here, the full table.
Thank you in advance for all the help!
For web page retrieve, you can use the Web::Scraper, HTML::DOM, and also the LWP related modules.
And for SQL, the DBI module is very powerful. You can search these using the cpan.
Your question seems to be how to do webscraping. I don't see how MySQL would come into play with this. For webscrapint I suggest that you look at the CPAN modules WWW::Mechanize and HTML::TableExtractor
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
Questions asking us to recommend or find a tool, library or favorite off-site resource are off-topic for Stack Overflow as they tend to attract opinionated answers and spam. Instead, describe the problem and what has been done so far to solve it.
Closed 8 years ago.
Improve this question
Does anyone know of a framework to create web forms that requires little code and can send form data to a database, email address, or other api such as Microsoft CRM? I am looking for a framework where I can define the form and fields in a database which then creates the form and web endpoint automatically. Ideally I would like the form data to be stored in a normalized database. A .net solution would be the best.
It sounds like you're looking for an off-the-shelf solution, of which there are many. #David indicated in his comment that Microsoft LightSwitch and InfoPath are viable options, to which I'd agree. These offer the path of least resistance -- minimal hassle for setup, and forms can more or less be created without any coding required by the user.
If you're feeling adventurous and want to use a more capable framework, Microsoft ASP.NET Webforms is another technology that does exactly what you want really, really well. It is considerably more dynamic/open/complex than Lightswitch/Infopath, but on the whole is an excellent option for someone that just needs to get editable forms/grids up and running in the shortest amount of time possible.
ASP.NET's drag and drop components are easy to use and configure -- you can literally wire up forms/grids to a database without having to code anything at all. Another great thing about using Webforms is that you get the support of the entire .NET framework, which as hundreds(?) of components that you can take advantage of (grids, widgets, charts, etc. etc.).
.NET itself is a framework PHP has lot of options in way that you are searching :)
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've been working on a framework in AS3 that I want to release, but first I obviously need to prepare some documentation for it.
I've noticed that quite a few sites have the exact same layout, functionality etc as Adobe Livedocs, which has let me to believe that there's something open source out there for creating online documentation.
Here's some examples:
http://livedocs.adobe.com/flash/9.0/ActionScriptLangRefV3/
http://papervision3d.googlecode.com/svn/trunk/as3/trunk/docs/index.html
http://www.fisixengine.com/api/
Would anyone be able to point me in the right direction for tools that I can use to prepare online documentation?
Ideally the system would be specifically suited for documentation in ActionScript 3. I don't have a requirement in terms of the documentation being automatically generated either - if there's something out there that looks/works nice I'm happy to manually create the documentation (provided it comes with tools for easily adding classes, arguments, etc).
Adobe has a free tool called ASDoc. It generates documentation which follows the official Adobe patter. Frankly, it isn't worth it though. The ASDoc tool is buggy and unreliable. If it has difficulty finding an import, if an import isn't used, a comment is not correctly formatted, or you have your source code spread out in any sort of unexpected way, it simply breaks.
My company has lost over 50 developer hours (a few people tried to get a couple of different projects to work and failed) in an attempt to get around these limitations and our solution? We used NaturalDocs (A JavaDoc compiler). Is it perfect? No. Is it comparable to ASDoc in output? Sort of, it isn't as neat, and it would be nice if it treated things a little differently, but it works to display the documentation.
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'm looking for a way to search through our subversion repository or just packaged source code.
Are there any downloadable servers/tools like Google Code Search to index source code (preferable with support of version control systems like svn) and allow us to search in it?
Is there any tool that will index documents too?
FishEye or OpenGrok possibly.
There are many tools that will index documents.
I believe the source code for Google Search is available here. It's implemented in Go
https://code.google.com/p/codesearch/
Google made their internal Kythe source code analyser toolset available on GitHub, see http://www.kythe.io/.
It does a lot more than a simple text-level indexer. At the core it builds an AST graph from the source code and provide tools that operate on it and query it.
I use glimpse for code search. I use the free command line tool, and not the paid web interface. It's very quick, and can be combined with other tools to quickly find what your looking for. I find it's easy to setup multiple repositories for different branches of the code. Additionally, I've created a few scripts to help query, format, and colorize the results.
A language-sensitive source code search engine can be found
at SD Source Code Search Engine. It can handle many languages at the same time.
Searches can be performed for patterns in a specific langauge,
or patterns across languages (such as "find identifiers involving TAX").
By being sensitive to langauge tokens, the number of false positives is reduced,
saving time for the user. It understands C, C++, C#, COBOL, Java, ECMAScript, Java, XML, Verilog, VHDL, and a number of other languages.
[I'm a principal at the company]
Hound - code search tool with Web UI