Git Product home page Git Product logo

Comments (7)

dufferzafar avatar dufferzafar commented on May 20, 2024 2

I created this using Pandoc. Had to modify the Readme a bit to please Pandoc/LaTeX etc.

The output looks pretty decent to me. It has working table of contents and is only ~400 KB in size.

Download WTF Python.pdf

Command: pandoc -f gfm --pdf-engine=xelatex --template=jgm.tex -V geometry:margin=1.1in README.md -o WTF.pdf

from wtfpython.

dirksteindorf avatar dirksteindorf commented on May 20, 2024

Hi satwikkansal,

I would try converting your README.md with pandoc at first, just to see if the results are okay:
https://pandoc.org/getting-started.html
https://pandoc.org/demos.html
https://pandoc.org/epub.html

Pandoc support a huge list of formats, including pdf and epub, so that could help you a lot.
Maybe you just need to do some formatting and then be done with it, if you're lucky.

Code can be quite tricky in ebooks, because of the different display sizes of the readers. Maybe you could just stick to one size or one ebook reader at first. Amazons Kindle Textbook Creator could be helpful for this: https://www.amazon.com/gp/feature.html?docId=1002998671

I hope that helps a bit. :)

from wtfpython.

satwikkansal avatar satwikkansal commented on May 20, 2024

Hey @dirksteindorf

Thanks for the suggestion. Let's give these tools a try! If it works well, we can share the pdf this way for the time being.

from wtfpython.

satwikkansal avatar satwikkansal commented on May 20, 2024

I had another general query as well. I feel that books are supposed to be more formal, organized: following a proper format, and descriptive than wtfpython is right now (maybe I'm wrong believing that).

So if someone can help me figure out if this project is actually worth a book, and up to how much extent (according to them) should we work in formalizing the structure and content, then it'd make things easier to plan.

from wtfpython.

satwikkansal avatar satwikkansal commented on May 20, 2024

Hi @dufferzafar

Thank you so much for this, and yes, it looks pretty neat.

There's one minor issue, the hyperlinks in TOC aren't still working in some cases. Trying to figure our the reason why...

from wtfpython.

satwikkansal avatar satwikkansal commented on May 20, 2024

Ah, got it. All the titles ending with non alphanuerice characters (like * and !) aren't properly functioning in TOC hyperlinks.

from wtfpython.

satwikkansal avatar satwikkansal commented on May 20, 2024

I think for now, I can remove those characters at the end and generate the pdf. And I'll create an upstream issue for it, so that we can have a better approach later on.

from wtfpython.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.