radare2-book icon indicating copy to clipboard operation
radare2-book copied to clipboard

[FR] other e-book formats

Open ildar opened this issue 5 years ago • 10 comments
trafficstars

epub/fb2 are very desirable for self-education. PDF is also demanded mostly.

ildar avatar Sep 25 '20 18:09 ildar

You can do epub and PDF by running npm epub already

Maijin avatar Sep 25 '20 21:09 Maijin

I can do it. but still think it's a good idea to give noobs a link

ildar avatar Sep 26 '20 03:09 ildar

As an example on how I'd like a ebook to look like. https://flibusta.is/b/619884/

ildar avatar May 07 '21 11:05 ildar

I dont understand this link. But the r2book is availablr in html, epub and pdf. Its autogenerated so you dont tneed to generate anything . Just click the link. Im closing this issue because its already available

trufae avatar May 07 '21 13:05 trufae

That's fair. Could anyone please share a link to a ready-built epub? as I wrote:

but still think it's a good idea to give noobs a link ... including right in the book itself. Please?

ildar avatar May 07 '21 17:05 ildar

Its in the first link if you google for r2book or see the radare website

https://radare.gitbooks.io/radare2book/content/

trufae avatar May 07 '21 17:05 trufae

Oh! I'm sorry, but we have a messy mess here:

  1. https://github.com/radareorg/radare2book has two links to http://book.rada.re/ ,
  2. which is the outdated version of the book and should be changed to redirect to the current version or terminated;
  3. all the gitbook links are broken.

ildar avatar May 07 '21 20:05 ildar

Yes, I just realized that xvilka removed the gitbook account associated to this repository when they forked r2.. >_< .. well now I can setup things in github ci without depending on anyone or any external service or privative tooling. So this issue wont happen again.

I just integrated pandoc into the CI pipeline to generate the PDF file in there. it's far from perfect, but it's a beginning, you are welcome to try it out and send PRs improving the epub/pdf generation.

The root makefile should be the one in charge to make those PDF/EPUB files

Thanks!!

trufae avatar May 10 '21 10:05 trufae

I didn't remove gitbook when we did a fork. It has happened before because GitBook switched to the paid account, and we migrated to the mdBook:

  • https://github.com/radareorg/radare2book/commit/26215a96f9fbf023805769f9456fa81dd29759cd
  • https://github.com/radareorg/radare2book/issues/301
  • https://docs.gitbook.com/resources/gitbook-legacy

XVilka avatar May 10 '21 10:05 XVilka

I see. Ill just fix all those links and use mdbook/pandoc instead

trufae avatar May 10 '21 14:05 trufae