I got frustrated with not having a good way to print Markdown files from GitHub (root level repo READMEs and individual .md/mdown files).

It's super simple to use: just replace 'github.com' with 'gitprint.com' (when on a GitHub markdown file page) and it will convert it to a beautiful print-friendly PDF and prompt you to print.

Any feedback would be appreciated. (It's just a fun side project, but would like to improve it as I think it could be useful for like-minded people)

   Producer: Qt 4.8.4 (C) 2011 Nokia Corporation and/or its subsidiary(-ies)

  $ pandoc -s -S -o gitprint.pdf FILE.md

However, a caveat. It is not mentioned in the documentation, but Gitit does not enable PDF export by default, when Pandoc is more than capable of doing so? Why? Because, in all fairness, it can add significant load. According to the conf file comments.

> pdf-export: yes

> # if yes, PDF will appear in export options. PDF will be created using

> # pdflatex, which must be installed and in the path. Note that PDF

> # exports create significant additional server load.

How much load, I am not sure. I would love to see a similar Happstack app like this program that runs gitit or the new fork gitit2, rewritten for Happstack updates now that the API has matured. This makes me think performance is an issue.

As an aside, I know ShareLatex opened up their code. I have not had time to check, but I was curious if they do use standard Latex for generating files and if they do, how they make it performant (I know they have a couple layers, I watched their old Node/JS London talk, I mean hear Latex in particular) so fast for potentially thousands of people at once.

[0] https://gitprint.com/jgm/gitit/blob/master/README.markdown

Is it surprising that processing inline TeX equations or Bibtex citations takes more resources? No.

Compare and Contrast:

Gitprint's pdf of README: https://gitprint.com/jgm/gitit/blob/master/README.markdown

Gitit's html export of README: http://gitit.net/README?printable

If I don't care about the quality of the text layout gitit's printable html page is equivalent to the gitprint pdf. Adding Merriweather to default.html is trivial. But as another commentator pointed out maybe using a new trendy font might not be the best choice if you want decent unicode coverage; just in case one of your users is among the "minority" of people who were unsatisfied by the basic ASCII charset.

Moreover comparing gitprint's markdown support to pandoc as if it is apples to apples is silly.

Is Latex requiring processing power to generate PDFs that become professional publishing house books surprising? Of course not. Latex is sick. I was a non-tech student in college, and when I discovered Latex in a CS class my mind was blow and loved it for a while, despite fucking up regularly with its learning curve. (Funny anecdote: I even had a terrible philosophy professor in my liberal arts college senior year who went to Stanford and noticed he used Latex for everything, unlike any professor at my tech-illiterate school; he used it because his friend was this guy Donald Knuth; I kissed that guy's ass for the rest of the semester after that tidbit just for stories about Knuth). My point was scaling Latex in a server environment would be difficult, and I was addressing a few people equating this whole thing to Pandoc, which I did not find fair. Running Latex concurrently for lots of people sounds rough to me, but then again I never implemeneted anything nearly as complicated as that.

Gitit does not just give you just a printable HTML page. If you notice, gitit uses the Pandoc backend to export many formats. It might not set them as printable, but to see gitit+pandoc in action, look at the export menu to the bottom left corner of the default them on the page you link. You do not see the PDF format export, because as I mentioned in my original comment, by default Pandoc Latex+PDF support is not enabled because of said performance load.

I was speculating writing an equivalent of this service with Pandoc and Haskell is doable, but solely generating PDFs would be a load that might make it difficult at scale. I do not know. ShareLatex, who arguably is way ahead beyond my speculation because they implemented a powerful web-based Latex editor, did some very unorthodox (as far as just reloading Latex in the shell every time) architecture to make it fast and resilient.

I am not sure how to respond to the comment re Gitit and Pandoc. Gitit is basically a wrapper around Pandoc, and it is merely a web interface to everything Pandoc does for different document formats, and hackage clearly lists it as a dependency with version 1.10+.[0] I know they are not apple to apple comparison. It was just a speculation. In the other post I was actually using Gitit and Pandoc interchangeably because the latter is the integral component of the former.

I feel there is a type checking joke lurking in my last line, but I am too tired to find it.

[0] http://hackage.haskell.org/package/gitit-0.10.3.1

To be clear this project:

  1. Converts a certain unknown basic markdown syntax to html 
     (iff the filename is something that it recognizes[^1])
  2. adds css for Merriweather, Open Sans, Dejavu Mono and a silly iconfont
     (I prefer pandoc's pygments syntax highlighting over goofy icon)
  3. renders html->pdf using webkit by way of phantomjs. 

  $ pandoc -s -S -t html5 -o out.html README.md 
  $ wkhtmltopdf out.html out.pdf 

  $ pandoc -s -S -t html5 -o out.html README.md  
  $ phantomjs rasterize.js  ./out.html out.pdf Letter

The type checking joke is that I never compared gitit to pandoc. So don't worry about responding to any comment you think I made regarding gitit and pandoc.

[^1]: https://gitprint.com/jgm/pandoc/master/README = "Something went wrong! Couldn't process https://raw.github.com/jgm/pandoc/master/README/master/READM... = ROFLSATIRE

  javascript:(function(e,a,g,h,f,c,b,d)%7Bif(!(f=e.jQuery)%7C%7Cg>f.fn.jquery%7C%7Ch(f))%7Bc=a.createElement("script");c.type="text/javascript";c.src="http://ajax.googleapis.com/ajax/libs/jquery/"+g+"/jquery.min.js";c.onload=c.onreadystatechange=function()%7Bif(!b&&(!(d=this.readyState)%7C%7Cd=="loaded"%7C%7Cd=="complete"))%7Bh((f=e.jQuery).noConflict(1),b=1);f(c).remove()%7D%7D;a.documentElement.childNodes%5B0%5D.appendChild(c)%7D%7D)(window,document,"1.3.2",function($,L)%7B$('%23header, .pagehead, .breadcrumb, .commit, .meta, %23footer, %23footer-push, .wiki-actions, %23last-edit, .actions, .header,.site-footer,.repository-sidebar,.file-navigation').remove(); $('%23files, .file').css(%7B"background":"none", "border":"none"%7D); $('link').removeAttr('media');%7D);javascript:(function(e,a,g,h,f,c,b,d)%7Bif(!(f=e.jQuery)%7C%7Cg>f.fn.jquery%7C%7Ch(f))%7Bc=a.createElement("script");c.type="text/javascript";c.src="http://ajax.googleapis.com/ajax/libs/jquery/"+g+"/jquery.min.js";c.onload=c.onreadystatechange=function()%7Bif(!b&&(!(d=this.readyState)%7C%7Cd=="loaded"%7C%7Cd=="complete"))%7Bh((f=e.jQuery).noConflict(1),b=1);f(c).remove()%7D%7D;a.documentElement.childNodes%5B0%5D.appendChild(c)%7D%7D)(window,document,"1.3.2",function($,L)%7B$('%23header, .pagehead, .breadcrumb, .commit, .meta, %23footer, %23footer-push, .wiki-actions, %23last-edit, .actions, .header,.site-footer,.repository-sidebar,.file-navigation').remove(); $('%23files, .file').css(%7B"background":"none", "border":"none"%7D); $('link').removeAttr('media');%7D);

I wish print css was more supported. I'll read blog articles describing my plight, but from 10 years ago. It makes me sad.

i really despise word processors, so i've been building out a jekyll/github pages site with each of my past jobs/projects as small markdown posts with the necessary metadata.

Then on the theme level I pull in the markdown files into a responsive site that degrades down all the way to mobile, and that has a print stylesheet that will generate a presentable resume from all this content.

I never really seem to get to the point of finishing the print stylesheet, because I seem to always find a job before I get to that point.

Still, at least now I can just update some small text files as I continue my career, and ultimately it just feels more sensible for me to manage that data than something like LinkedIn.

I was also thinking about adding some client side filtering of the past projects/jobs based on the technologies I tag them with, so I can generate a customized resume for each position. Maybe if I abstract it out into a separate project ...

There might be some JS hacks that could be done on github.com itself to render a more stylized view when ⌘+P is pressed. Avoiding the need for a special "print this page" button.

  javascript:if (location.href.slice(0,18) == "https://github.com" && document.body.classList.contains('page-blob')) location.href = 'https://gitprint.com' + location.href.slice(18)

Example: https://gitprint.com/chriscummins/pip-db Image tag: 

Otherwise excellent work.

In Chromium on Linux Mint, it wants to download the PDF file right away (doesn't wait for a button press). And it never actually loads, just keeps showing the loading icon.

(Aprt from that, though, this looks like a handy service :))

and i'm the person who told you last week that this service is a good idea. it is.

so change the link.

-bowerbird

no, actually, it was just right.

taking people to the print-set dialog when they have _clicked_a_link_ is not just confusing, it's unsettling.

especially when -- as is common here on hacker news -- someone has opened several different tabs and thus has no idea which caused this totally unexpected situation.

"unsettling" is quite deserving of the "awful" label.

(perhaps that word has an emotional connotation to you. but i'm using it the same way that i would describe, say, a "saturday night live" skit that was worse than usual.)

the "improvement" you have made is thus good... but...

...the current state is still unnecessarily confusing... clickers are shown a "jquery - new wave javascript" page. which is most definitely _not_ what they clicked to see.

you have a perfectly good home-page explaining the service, and how we can use it quite easily, with a button to click to summon up a canned example if we want that. excellent!

_that_ is where the h.n. link should go -- your home page.

welcome people at the front door, and _then_ give the tour.

don't just dump people into the middle of your canned demo, when some of them (certainly those who opened multiple tabs) will not even know exactly how they arrived there, or why.

it would have been a little bit better if your demo content was an explanatory page about gitprint itself. but even then, linking to the home-page is still a much smarter strategy...

maybe you'll think this is "strong" too.

it's not. i'm just telling you like it is.

i don't have any emotion invested. this is dispassionate.

i don't even care if you heed what i say or not.

it's no skin off my nose. i'm just trying to help you.

remember, i was the _only_ person who commented on this when you posted it last week. "good idea", i posted...

so instead of getting criticized this week, you _should_ have said "thank you", and then implemented my suggestion.

there's still time...

-bowerbird

  - Syntax highlighting on code blocks
  - Ability to insert page breaks

https://gitprint.com/thearn/stl_tools

@see https://gitprint.com/reeze/tipi, but Chinese text didn't display correct :(

  $ pandoc -o out.pdf README.md

  $ pandoc  -o gist.pdf http://gist.github.com/BLAHBLAH