Live data from Hacker News

Retype: A self-hosted and free alternative to gitbook

retype.com

11–20 of 30 posts

Re: Retype: A self-hosted and free alternative to gitbook

#12

I was initially quite impressed with the quality of the output and the feature set available. Well done! In addition, the github actions seem to make this a very quick drop-in solution which is something I need for several projects now (and have been putting off due to the heft & process of existing tools). However, after looking through the documentation, I finally stumbled on the mention of a license requirement. T…

I added a link in the footer to the License. Certainly was not my intention in any way hide the license. Hope this helps. > The page limits, while high, are somewhat unsettling. Can you explain this _unsettling_ comment further? Do you find the limits too low? A lot of research was put into the 100 page as I found only about 3% of projects ever went >100 pages. > I would want to apply this to a handful of my open sou…

I appreciate the change to the navigation, it makes things a whole lot more clear!

> Can you explain this _unsettling_ comment further? Do you find the limits too low?

Perhaps I could have worded that better. I don't see myself hitting that limit any time soon, but it represents some amount of lock-in (though, less than typical since the everything is mostly plain markdown). My reluctance to use paid software that gates features or may disappear entirely is due to the lock-in and vanishing of previous tools I've used. Not to say that is what is happening here, perhaps I'm predisposed to side-eyeing non-open-source tooling since it is such a core part of my work. At least with an open core, I could fork and maintain the existing features should the business-side ever go under.

That said, thank you for also clarifying that the $99 pro license is only required if a site were to stretch beyond 100 pages. I may give it a go on one project, but I can't see myself committing completely.

Re: Retype: A self-hosted and free alternative to gitbook

#14
post #13

This doesn't appear to be a valid alternative to Gitbook. I couldn't even see a git integration feature which is a/the key feature of Gitbook. This feels more like an alternative to the plethora of static site generators that already exist.

Retype builds directly off Markdown files, which you can store anywhere, including GitHub. The retype.com website is built directly from a GitHub repo, see https://github.com/retypeapp/retype

The retype.com website is also hosted on GitHub Pages. Any change that is committed to the GitHub repo will trigger the website to be rebuilt by Retype using GitHub Actions, see https://retype.com/hosting/github-pages/.

Hope this helps clarify that Retype is even more tightly integrated with GitHub, or any other source management system. You have complete control and ownership of your source content files.

Re: Retype: A self-hosted and free alternative to gitbook

#16
post #3

One will want to be aware of the licensing for this: https://github.com/retypeapp/retype/blob/v2.2.0/LICENSE.md "Free" as in beer, it seems

> “UNDER NO CIRCUMSTANCES MAY YOU USE THE SOFTWARE FOR AN APPLICATION THAT IS INTENDED FOR SOFTWARE OR APPLICATION DEVELOPMENT PURPOSES.”

Perhaps I'm just not getting the point of this statement, but isn't this really broad and ambiguous?

Re: Retype: A self-hosted and free alternative to gitbook

#17
I really wish this was actually open source. It's hard to build communities around shareware. You could even dual-license Retype if you wanted to let homelab selfhosters enjoy and disseminate the product without turning them into potential hostages.

Re: Retype: A self-hosted and free alternative to gitbook

#19

I really wish this was actually open source. It's hard to build communities around shareware. You could even dual-license Retype if you wanted to let homelab selfhosters enjoy and disseminate the product without turning them into potential hostages.

Ya, I've thought about open-sourcing the project many times, but there doesn't seem to be much upside.

Re: Retype: A self-hosted and free alternative to gitbook

#20

What are the advantages of Retype compared to BookStack? https://www.bookstackapp.com/

BookStack looks interesting, but certainly one massive advantage Retype has is just installation. I can have Retype installed, my website built, and running in a browser in a 10 seconds.

With Retype, your content source are simple Markdown `.md` text files. BookStack stores your data in a database, and in order to host a website you need a PHP webserver, Maria DB, etc.

A Retype generated website can be hosted for free using GitHub Pages. The retype.com website is hosted on GitHub Pages, see https://github.com/retypeapp/retype.

Hope this helps.

Post reply on HN