{"id":27361361,"url":"https://github.com/mkropat/dapper-invoice","last_synced_at":"2025-04-13T01:41:05.925Z","repository":{"id":30230395,"uuid":"33781504","full_name":"mkropat/dapper-invoice","owner":"mkropat","description":"A billable-time invoice featuring style over substance","archived":false,"fork":false,"pushed_at":"2023-08-24T23:43:51.000Z","size":459,"stargazers_count":200,"open_issues_count":4,"forks_count":65,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-03-09T13:03:23.814Z","etag":null,"topics":["invoice","latex"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mkropat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-11T15:43:54.000Z","updated_at":"2025-01-15T19:21:38.000Z","dependencies_parsed_at":"2022-08-30T03:21:22.536Z","dependency_job_id":null,"html_url":"https://github.com/mkropat/dapper-invoice","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkropat%2Fdapper-invoice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkropat%2Fdapper-invoice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkropat%2Fdapper-invoice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkropat%2Fdapper-invoice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mkropat","download_url":"https://codeload.github.com/mkropat/dapper-invoice/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248654026,"owners_count":21140236,"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","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":["invoice","latex"],"created_at":"2025-04-13T01:41:05.108Z","updated_at":"2025-04-13T01:41:05.912Z","avatar_url":"https://github.com/mkropat.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"## dapper-invoice\n\nA billable-time invoice featuring style over substance.\n\n![Example Screenshot](http://i.imgur.com/q78jtGu.png)\n\n### Pre-Requisites\n\n- [TeX Live](https://www.tug.org/texlive/acquire-netinstall.html)\n- TeX xetex (siunitx.sty)\n- TeX science (fontawesome.sty)\n\n— or —\n\n- [Vagrant](https://www.vagrantup.com/downloads.html)\n\n— or —\n\n- [Docker](https://www.docker.com/get-started)\n\n### Generating an Invoice\n\n#### Using TeX Live Locally\n\n```\ncp example.tex your-invoice-101.tex\n# make some changes to your-invoice-101.tex\nmake your-invoice-101.pdf\n```\n\nYour invoice will be created as `your-invoice-101.pdf`\n\n#### Using Vagrant\n\n```\ncp example.tex your-invoice-101.tex\nvagrant up  # this may take a while the first time\nvagrant ssh -c 'cd /vagrant; make REPORT=your-invoice-101 watch'\n```\n\nNow whenever you make changes to `your-invoice-101.tex` on your host machine,\nthe watcher inside the VM will automatically build `your-invoice-101.pdf`,\nwhich will be saved back to the host machine.\n\nWhen finished editing, input \u003ckbd\u003eControl\u003c/kbd\u003e-\u003ckbd\u003eC\u003c/kbd\u003e to stop the\nwatcher, then run:\n\n```\nvagrant halt\n```\n\n#### Using Docker\n\nUse Docker Hub's [`blang/latex`](https://hub.docker.com/r/blang/latex/) image that comes with a matching .sh file.\nWhen you first run this .sh file, it will pull the docker image that includes\nall of the latex dependencies.\n\n```\nwget https://raw.githubusercontent.com/blang/latex-docker/master/latexdockercmd.sh\nchmod +x latexdockercmd.sh\n./latexdockercmd.sh  # will pull down image on first use\n```\n\nThen, you can use the .sh file as you would xelatex:\n\n```\ncp example.tex your-invoice-101.tex\nlatexdockercmd.sh xelatex [options] your-invoice-101.tex\n```\n\nYou invoice will be created as `your-invoice-101.pdf`\n\n### Documentation\n\nSee [example.tex](example.tex) and [dapper-invoice.cls](dapper-invoice.cls) for details.\n\n### Inspiration\n\nI am not a designer. Inspiration for the design comes from\nborrowing design ideas from good looking invoices people have published\n[on the\nnet](http://www.smashingmagazine.com/2009/11/05/invoice-like-a-pro/). The\nresulting design is not even in the same league, but I think it gets the job\ndone.\n\nI am also not a LaTeX author. The code borrows heavily from the\n[moderncv](https://launchpad.net/moderncv) package (which I can't recommend\nenough), as well as numerous other packages.\n\n### Licensing\n\nThe code I have written I release under the MIT license.\n\nTwo different font packages are included in the repo for convenience:\n\n- OpenSans (Apache License v2.00)\n- Font Awesome (SIL OFL 1.1)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkropat%2Fdapper-invoice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmkropat%2Fdapper-invoice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkropat%2Fdapper-invoice/lists"}