{"id":32372643,"url":"https://github.com/cako/pdfnoter","last_synced_at":"2025-10-24T21:55:40.809Z","repository":{"id":142054705,"uuid":"2176990","full_name":"cako/pdfnoter","owner":"cako","description":"Annotate PDFs from a text file containing the notes.","archived":false,"fork":false,"pushed_at":"2011-08-12T02:34:02.000Z","size":268,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-03-12T09:41:55.995Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cako.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-08-09T01:48:22.000Z","updated_at":"2023-03-12T09:46:13.567Z","dependencies_parsed_at":"2023-03-12T09:46:13.245Z","dependency_job_id":null,"html_url":"https://github.com/cako/pdfnoter","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/cako/pdfnoter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cako%2Fpdfnoter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cako%2Fpdfnoter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cako%2Fpdfnoter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cako%2Fpdfnoter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cako","download_url":"https://codeload.github.com/cako/pdfnoter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cako%2Fpdfnoter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280872010,"owners_count":26405606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-24T21:54:35.948Z","updated_at":"2025-10-24T21:55:40.803Z","avatar_url":"https://github.com/cako.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"README\n======\n\nIntroduction\n------------\n\nAnnotating PDF files is hard. There are a few\noptions, but none of them are good enough for the\ntechnically inclined. Most PDF annotators use either\nASCII text or free form tools.\n\nThe question arises: How does one annotate a PDF\nwith LaTeX notation. The answer is, you simply\ndon't.\n\nThis little script might be the beginning of a\npositive answer. The idea of the solution is to\ncreate another PDF with the annotations, then\n\"stamp\" it on the original PDF one needs to\nannotate.\n\nThe manual process was first described on [this\nblog](http://3diagramsperpage.wordpress.com/2011/07/29/mathematical-annotations-in-pdf-documents/).\nAfter the author contacted me, I took it upon myself\nto automate the process a bit, and the results so far include this script and my\nother project, [annotate-pdf](https://github.com/cako/annotate_pdf). Hopefully, \nI won't stop here, and will find even better ways to quickly annotate PDFs.\nThe idea is to eventually embed this type of annotation in popular PDF readers,\nor even write another PDF reader dedicated to annotations.\n\nRequirements\n------------\n* [perl](http://www.perl.org/get.html)\n* [pdftk](http://www.pdflabs.com/docs/install-pdftk/)\n* [pdfinfo](http://www.foolabs.com/xpdf/) (part of the xpdf utilities for PDF files)\n* pdflatex\n* textpos package for LaTeX\n\nInstallation\n------------\nThe tricky part here is the installation of the requirements, and not the program itself.\n\n### Ubuntu\n\n    sudo apt-get install perl pdftk poppler-utils texlive-latex-extra\n\n### Windows\n\nDownload Strawberry Perl [here](http://strawberryperl.com/) and install it.\n\nDownload `pdftk` [here](http://strawberryperl.com/). To install it, copy\nthe two files (a `.exe` and a `.dll`) to the\n`C:\\WINDOWS\\system32\\` folder.\n\nDownload `pdfinfo` from\n[here](http://www.foolabs.com/xpdf/download.html),\nand copy `pdfinfo.exe` to the `C:\\WINDOWS\\system32\\` folder.\n\nFinally, install a LaTeX distribution such as\n[MiKTeX](http://miktex.org/2.9/setup) if you\ndon't already have one.\n    \nInstructions\n------------\n\nWrite your notes in a text file, following the format specified in the\n`example.tex` example file. (The format is super simple,\n[check it out](https://github.com/cako/pdfnoter/blob/master/example.tex)!)\nThen run\n    \n    perl pdfnoter.pl INPUT_PDF INPUT_NOTES\n\nYou are done! The annotated file is produced on the same folder as the\n`INPUT_NOTES` file.\n\n\nExample\n-------\nThe simplest note is this one:\n\n    \u003cbegin:note\u003e\n    1, 5cm, 1cm, 2cm\n    This as complicated as notes get!\n    \u003cend:note\u003e\n\nIt produces a 5cm wide container, 1cm from the left and 2cm from the top of page 1.\n\nAnother note, found in [example.tex](https://github.com/cako/pdfnoter/blob/master/example.tex)\nproduces the following PDF given the background *lorem ipsum* dummy PDF.\n\n![Looks good to me!][img1_45]\n\n[img1]: http://i.imgur.com/58pDA.png\n[img1_45]: http://i.imgur.com/Bhp3O.png\n\nTo Do\n----\n* Create `.exe` for Windows with bundled programs (and their sources!)\n* Allow comments\n    \n\nPlease Contribute!\n------------------\nThis code is licensed under the GNU General Public\nLicense version 3. Go ahead, fork it and improve it!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcako%2Fpdfnoter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcako%2Fpdfnoter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcako%2Fpdfnoter/lists"}