Recommendations of static site generator which accepts Markdown documents? [closed] - generator

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
I'm looking for static site generator which accepts Markdown documents as input source code.
I used Markdoc, but it looks abandoned. And it doesn't copy static file in source document folder. So I'm installing docpad now. Anyway I want to try other implementations. Can you recommend some nice implementation like that site generator?

http://staticsitegenerators.net is a crowd-sourced definitive listing of all the static site generators, their github stars, their website, their language, created and updated dates, etc.
+1 for DocPad, I've found Jekyll to be quite crippling with it's lack of extensibility (not enough markups supported, difficult to filter documents in content listings based on certain criteria, hard to write extensions, etc...)

You can also take a look at nanoc, which is Ruby based and actively being developed, too.

Cabin is a node.js static site generator powered by Grunt. It currently has three beautiful blogging themes available out of the box. Getting started takes like 45 seconds. Here are the available themes, with links to installing each:

Jekyll is quite mature and actively being developped.

Poole is another one. Conceptually it's something in between plain Markdown to HTML conversion and more sophisticated site generators like Hyde.
Poole uses one global HTML skeleton file to inject the HTML versions of Markdown source pages into. Poole has basic support for generating content by embedding Python code in page source files. This is a dirty merge of content and logic but a pragmatic solution to get things done fast for simple sites. No need to learn a template or preprocessing engine.
Poole may be a good choice if you are familiar with Markdown and Python and if you want to build a rather simple site with only a spot of generated content.
Disclaimer: I'm the developer of Poole.

I recently moved my blog from googlesites to node based Wintersmith. I am fairly impressed with the flexibility and markdown support it provides. Also there are several templates and open source referral websites available on their git repository.

If you are on a mac, I recommend Hammer (http://hammerformac.com/). Supports Markdown and also SASS (with Bourbon), CoffeeScript and HAML.

Related

CMS recommendations for HTML CSS competent noob developer [closed]

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
so after a long break from it, I've decided to pick up web development again, and I'm having just as much trouble as ever, trying to pull apart and customise these CMSs. I'm getting a bit frustrated with it.
I'm pretty good with HTML and CSS, and can happily build websites that aren't linked to a Content Managment System (HTML, CSS, Javascript), but the complexity of a CMS seems to be too much for me to work with and understand.
I was hoping someone could recommend a dead simple framework for me to work with. Something that's really simple to understand how it works. I like the idea of a Flat File CMS, So far I've looked at Stacey, Grav and Kirby. I'm told these are simple to work with, but I'm still struggling to customise, and make the templates my own.
Ideally, what I'm looking for would be a cms where I could build the site in HTML and CSS and tack-on variables for things like image grids and menus into the HTML. Anyone heard of anything like this?
Cheers.
Self-hosted Wordpress would be my recommendation. As a 10+ year full-time web developer, I've used many CMSs and this one is always my go-to solution these days. I seem to be constantly migrating clients away from other outdated platforms to Wordpress. Or you can use Wordpress.com if you don't want to go the self-hosted route.
If you work well with HTML and CSS you can make any style or markup changes you require. If you haven't used PHP before, you'll have plenty of time to get familiar with it. Once you are comfortable with some basic PHP, you can begin adding whatever functionality you want to your site via a plugin or by placing custom functions in the functions.php file of your theme.
If you haven't built anything with Wordpress yet, or if you aren't comfortable installing it on your webhost manually, you can use a webhost that has Fantastico to auto-install Wordpress for you.
There are tons of mobile-responsive themes out there that you can use as a starting point for your site, many of which are free. It is recommended to use a child-theme for making your customizations. This will prevent a theme update from erasing your changes. If you are going to use a lot of javascript files it is also recommended to register and enqueue them inside the functions.php file.
It may take some time to familiarize yourself with Wordpress, but it should be well worth it.
For more info on all things related to Wordpress, check out the codex:
https://codex.wordpress.org/
There is also a new Wordpress Code Reference:
https://developer.wordpress.org/reference/
And if you run into any specific issues, first search here on Stack Overflow for the answer–it will usually be here already. If you can't find anything on your specific issue, create a new post with the details and someone will usually be happy to assist you.
Good luck!
You can start with Odoo CMS. It was prettier now on version 9, with more feature and flexibility.
You can download the complete source of odoo, and develop it develop it in local before deploy on your server.

Converting HTML to doc(x) and / or PDF [closed]

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
I have to convert html to the doc(x) and pdf format.
I found aspose, but this tool can do a lot of more work than i need, and thats why it isn't really cheap.
Are there similar tools, which can just do this conversion ?
I need this on a Desktopapplication where no word / office is installed
*Just for Info Finally bought asponse words. all other options weren't as good as this tool
Assuming that these are essentially “documents” and not fancy graphical web pages (i.e. you'd like them to be legible, but aren't deeply concerned with the minutiæ of web layout formatting), you can use LibreOffice to convert them; either manually (open, export as…) or using the "headless" mode, e.g.:
soffice -headless -convert-to pdf -outdir pdfs/ *.html
soffice -headless -convert-to doc -outdir docs/ *.html
Free, cross-platform, but a bit of a hefty install. (I think it's nearing the half-gigabyte mark for the full suite with all the plug-ins installed, but you should only need the Writer component)
Maybe this http://kitpdf.com might help. I tried it, it's free and really easy to use.
You can use ABCPdf:
http://www.websupergoo.com/products.htm
I can't speak for docx format, but you might look into DocRaptor to convert HTML to PDF format. It definitely handles CSS styling better than comparable programs, and doesn't just give you an image like creating a PDF with Photoshop.
If the webpage is or can be hosted then you can download an extension for Google Chrome called Screen Capture, this allows you to take a full screen grab of the webpage then you can paste it into Photoshop and Save As a .pdf (that is assuming you have Photoshop that is)

Convert pdf, doc, ppt to html5 [closed]

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
I've googled (without any luck) for open source software that can convert doc, ppt, and pdf to HTML5. (Exactly what Scribd does) Are there open source equivalents to the type of conversion Scribd does?
If anyone knows of a paid service, that would also work. Scribd has an API, but that's for use with the flash viewer. Also, I would like to host my own content as I need further control over converted html document.
You're unlikely to find a single offering that does all this, especially in the open source world. It's more likely that you'll end up relying on a mishmash of things, and may even need to chain some converters in order to get to HTML. (Eg PDF -> ps -> HTML)
OpenOffice supports conversion to HTML, and can be called from the command line.
http://pdftohtml.sourceforge.net/ looks reasonably good at converting pdf to html.
For Doc that is Word ML or OpenXML format it's conceivable that you could use XSLT transforms since both input and output formats are XML. I've seen some stylesheets floating around the net that do this, but YMMV.
Incidentally, why is there a specific requirement for open source? MS Powerpoint already supports save-as-HTML for example.
Open Office will convert pdf to html but you'll take a hit to design quality.
I suggest either: Crocodoc as a paid service (It provides different flavours for different platforms such as Python,Ruby,Java,PHP Developers are allowed to work on their APIs.) or waiting for an official Adobe tool (it's in the works).
For PDF to HTML conversion, pdf2htmlEX seems like a pretty good tool (looking at all the examples/samples):
https://github.com/coolwanglu/pdf2htmlEX
For pdf there is an open source project started by mozilla and it's very good: https://github.com/mozilla/pdf.js/
You can see a hello world example : https://github.com/mozilla/pdf.js/tree/master/examples/helloworld
For the rest of document types I think LibreOffice said that are planning to build something in html5, but so far there isn't anything done.
http://wvware.sourceforge.net/
wvHtml: convert your Word document
into HTML4.0.
Possibly:
http://www.abisource.com/
but in this case it looks like "open doc" > "export html" manually, maybe plugins help. Not sure, what do you mean: "source software that can convert".
Or this:
http://www.zope.org/Members/sf/NuxDocument
Also the pdftohtml will give you an html page output.But you will have to work upon its graphical interface.Since it doesn't seems to be very interactive.
I know the question is bit old however I have found new Open source tool called flaxpaper http://flexpaper.devaldi.com/

Installable CMS similar to CushyCMS? [closed]

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
I'm looking for a CMS system that works similar to CushyCMS, but that I can install on my own server?
I love the functionality and ease of use CushyCMS provides for simple, small sites where setting up and installing a traditional CMS (Drupal, Wordpress, TYPO3) are not necessary.
Anyone have any ideas?
Thanks!
Troy
Perch is an excellent lightweight CMS.
For what you're after I'd reccomend ImpressPages CMS
http://www.impresspages.org/
It doesn't use html tags, but its a very easy "drag and drop" style. with clear toolbars available to the site admin, obviously WYSIWYG editing isn't everyones favourite (it's not mine) but for 5 or so pages, it's perfect.
Orbis CMS is an open source alternative to CMSs like CushyCMS. It's built on the same priciples (simplicity, ease-of-use) and features a stylish interface, but is self-hosted and free.
"modify html pages simply by adding a class but that I can install on one of my own servers"
Unify does this very nicely unify.unitinteractive.com it costs $24.49 per domain, simply upload the unify folder to your webspace and add class="unify" to the areas in the html you want editable.
Another one ideal for a site of 5 pages is pulsePro http://pulsecms.com/
If you're looking to write some of your own code/html it might be worth looking at django-cms
Well, I don't know of any yet, but if you want an alternative online service then check out Surreal CMS. You can also try out Simple CMS, but it's still very new (released into beta a day or two ago).
You should look at Zimplit!
SnippetMaster is pretty cool. It's too bad that it's not open-source and free, but at least it has generous and inexpensive licensing schemes (normal, re-brandable, etc.)
It would be nice if it used class names for the content regions, but it uses HTML comments formatted a special way (like IE conditionals) so it's still valid html.
http://www.snippetmaster.com
I built this one www.kitgui.com so programmers can be programmers in their own language / framework of choice and use a REST-style interface to pull content and HTML 5 javascript reference to be able to let clients manage the editing experience directly on the website pages themselves. HTML 5 allows for the cross-site security to occur these days so everything just made sense to do this. In my ecommerce business its all about how fast you can setup things to get them out the door and get paid. KitGUI makes it so easy you can't really appreciate it unless you try it out. This is brand new so I have no idea if programmers like it or not except for my own devs who are biased of course. I know clients do for sure so please give me some feedback on it if you have time to investigate as I worked my ass off to launch it.
Something which is very similiar to CushyCMS is Unify CMS.
They have a demo which you can try before you buy.
You will see that Unify is very similar to CushyCMS and I quote:
You do not need to know PHP, nor do you need to write your code
specifically for Unify. In order to create editable areas on your
site, you only need to add “unify” classes to each element. That’s it.
There is no Database to setup, you just upload the files via FTP (or similar) and start adding in classes where you want to have editable regions. They have repeatable regions as well.
Unify currently costs 24.49 and is backed by a 45 day money back guarantee.
Support is powered by Desk.com
Take a look at Unify requirements and you will see you can run this in almost any server on the planet; well, almost any server :)

How best to write documentation targeting both HTML and PDF? [closed]

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
Latex-to-html converters I've seen in the past have been pretty awful. Editing raw html is no fun and doesn't seem to translate well to the printed page. How do others solve this problem? Links to examples (both pdf and html) would be great.
Added: Another similar question was just asked:
What formatting language should I use for project documentation
For documenting code, I also recommend Sphinx. ReStructured Text is nice because it is readable and somewhat marked up in plaintext, and can do a nice job converting to html and to pdf. I still like LaTeX for certain things. My wife and I use LaTeX to write our christmas letter, which we mail out via snail mail. The pdf version is pretty fancy, with two columns, and headers and footers. The html version is simpler. I convert with plastex. Examples here:
http://fedibblety.com/annualReports
I don't think any binary format is a good choice (Word) for any sort of document that you might like to read 10 years from now. That is one of the nice things about LaTeX.
Yes, LaTeX-to-HTML converters used to suck (you've probably tried LaTeX2HTML), but of late they've got better. Tex4ht is highly configurable, and produces nice XHTML+CSS. See also other converters.
You can also use Docbook, if you can bear to write in it. There are converters from DocBook to both HTML and LaTeX (or to PDF directly); an example of the latter is dblatex.
See this post: LaTeX vs Docbook.
After many years of anguish and several false starts, I'm about to revisit this, and I'm going to give Sphinx a try. It can generate HTML or LaTeX from ReStructured Text.
I'm hoping it will be a much "lighter" option than full DocBook, but with many of the advantages.
You could take a step back and use something like DocBook and render to PDF via LaTeX and HTML straight from the DocBook files. Alternatively, Adobe Technical Communication Suite (Framemaker) will let you single-source a document to PDF and HTML. See this posting for a rundown on various technical documentation systems.
This is a personal choice but Latex in theory is perfect however in practice it's pain-in-the-arse. I'm using VS.NET HTML editor + raw HTML edit when I need it.
So I think using an WSIWYG HTML editor is best choice. You can always use a simple tool to convert it to PDF, and you can always edit HTML when you need something advanced. Also it's easier to put online when you need.
That's how I'm managing my software documentations and works fine for me.
PlasTeX looks like a nice latex-to-html converter, though I haven't tried it myself.
My friend Rob Felty wrote a blog post extolling its virtues:
http://blog.robfelty.com/2008/03/19/finally-a-better-latex-to-html-converter/
AsciiDoc looks like an interesting possibility.
Read about EPUB format. Its e-book format. http://en.wikipedia.org/wiki/EPUB
Since the answer mentioning Asciidoc was somewhat short on examples, here are some of the things your are looking for:
A pdf generated with Asciidoc
A cheatsheet with a side by side of the Asciidoc markup and the html result.
A list of publications done using Asciidoc, including O'Reilly books and the git documentation (to see both ends of the user scale).
I'm not sure that latex is really the best tool for this. The trouble you're having with the usual latex to html converter is indicative of the problem: html is simple not as expressive as latex.
If you insist on latex to html, take care to use a limited subset that can convert reasonably.
I've used TeXinfo in the past and it does a good job. Here's an example: http://yootles.com/api. I'd prefer to stick with LaTeX though instead of use another language.
If everything else fails you could grab an LaTeX to XML converter and write a simple XSLT stylesheet to convert it to HTML, or create a CSS style sheet and attach it to the XML file directly.
We've been using WebWorks ePublisher (www.webworks.com) which offers both multiple single-source formats (we are using Word) and the ability to output to many output formats (we output to Adobe PDF and Online Help (.CHM).
We were facing this problem in an academic project that involved Eclipse software, and we used plastex to convert Latex to HTML and Eclipse Help. Getting it to work was quite difficult, but the end result looks really nice. You can see all three versions here:
http://handbook.event-b.org/
Further, as this is an open project, the code (build scripts) are available. We have a continuous build system (Jenkins) that rebuilds everything when new Latex is checked in. This is particularly nice, as contributors don't need to install the toolchain on their systems. They just check in the new Latex and check on the server whether the HTML was produced correctly. Sources:
http://sourceforge.net/p/rodin-b-sharp/svn/HEAD/tree/trunk/Handbook/org.rodinp.handbook.feature/
Best, Michael
I don't have enough points to comment, but to bolster the plastex answer, here is the updated plastex example link:
http://robfelty.com/2008/03/19/finally-a-better-latex-to-html-converter
LaTeX? Seriously? I wasn't aware anyone outside academia still used it. I'd go with HTML, which you can save as PDF from the web browser. If you really must have some advanced typographic stuff, go with Word instead - it has a way to save to HTML (probably not as clean as one would like), and you can save as PDF with a free plug-in (downloadable separately).
Oh, and I wouldn't bother using things like InDesign - they are overkill. Also, don't bother paying for Acrobat Professional - there is a zillion free solutions available.