Skip to content

Any chance of getting a PDF version? #106

Closed

Description

@roman-kashitsyn

First, thank you so much, the book looks extremely useful!

The online version looks amazing, but there's one minor issue: I prefer reading books away from computer, using my E-Ink device. I can imaging that a lot of people have similar preferences.

So a PDF version of the book (or at least instructions how to make one) would be very helpful.

Activity

  1. wenkokke commented on Dec 2, 2018

    @wenkokke
    Collaborator

    This should be possible, and I have created similar setups in the past – where .lagda source compiles to a website and to a PDF – but we're not currently working on this.

  2. wadler commented on Dec 3, 2018

    @wadler
    Member

    Roman, As Wen says, we're not working on this currently. If you would like to add a way to do this to the repository, that would be most welcome.

  3. reopened this on Dec 3, 2018
  4. Kwezan commented on Dec 7, 2018

    @Kwezan
    Contributor

    Ways to do this are relatively simple. You can use ready-made applications such as a Adobe Acrobat DC, which quickly and easy translates HTML pages into pdf files or even the PdfCrowd tool (https://pdfcrowd.com).

  5. wenkokke commented on Dec 14, 2018

    @wenkokke
    Collaborator

    @Kwezan Those tools might work, but they'll be translating the HTML to a PDF. Since we have Markdown source for the book, and we can translate the literate Agda parts to LaTeX using agda, I feel we can do much better if we set up a script which runs the book through LaTeX.

  6. ice1000 commented on Jan 10, 2019

    @ice1000

    FYI the 2.6.0 release of Agda will bring a new feature that translates the Agda codes in .lagda.md files into HTML and leave other parts preserved (so the output file can be post-processed by a markdown renderer and become nice HTML. Example: https://ice1000.org/lagda/MuGenHackingToTheGate.html).

  7. wenkokke commented on Jan 10, 2019

    @wenkokke
    Collaborator

    @ice1000 Awesome news! That'll be very useful! Unfortunately, at this point, there's a couple of other features of agda2html that we've come to depend on, but we might be able to switch over to just using Agda in time!

  8. ice1000 commented on Jan 11, 2019

    @ice1000

    Wow, you have agda2html. I didn't know about that.
    What features? Can you elaborate?

    Maybe it'll be helpful for improving Agda's HTML backend, too.

  9. wenkokke commented on Jan 11, 2019

    @wenkokke
    Collaborator

    @ice1000 Sorry, it's not exceedingly well-documented. It has the ability to:

    • strip implicit arguments from Agda code,
      to make the code more readable and look more like Haskell or Idris
    • whenever Agda inserts a link to the definition of a symbol,
      if it's a symbol from the standard library,
      create a link to the online HTML documentation of the Agda standard library
    • resolve custom Markdown links to Agda modules which are in scope, e.g., [...][DeBruijn],
      to the appropriate url, based on the local filesystem
  10. ice1000 commented on Jan 11, 2019

    @ice1000

    strip implicit arguments from Agda code, to make the code more readable and look more like Haskell or Idris

    In Agda 2.6.0 you'll have

    variable
     i : Level
     A : Set i
    
    id : A -> A -- A is generalized according to the variable definitions above
    id a = a

    Related docs: https://people.inf.elte.hu/divip/AIMXXVIII.pdf

  11. ice1000 commented on Jan 11, 2019

    @ice1000

    whenever Agda inserts a link to the definition of a symbol,
    if it's a symbol from the standard library,
    create a link to the online HTML documentation of the Agda standard library

    This is interesting! We haven't thought about that yet. Good idea!

  12. ice1000 commented on Jan 11, 2019

    @ice1000

    resolve custom Markdown links to Agda modules which are in scope, e.g., [...][DeBruijn],
    to the appropriate url, based on the local filesystem

    Modules! Why not use import TargetModule using () as a "link"? 😉

  13. isovector commented on Nov 3, 2019

    @isovector

    I'd love a PDF version of this!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementSuggests an improvement.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions