{"id":13791777,"url":"https://github.com/juliantao/qletter","last_synced_at":"2025-08-03T14:32:34.694Z","repository":{"id":128494572,"uuid":"544603599","full_name":"juliantao/qletter","owner":"juliantao","description":"Quarto extension for an opinionated letter template with customized letter head","archived":false,"fork":false,"pushed_at":"2024-06-05T21:41:30.000Z","size":168,"stargazers_count":9,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-29T07:39:54.188Z","etag":null,"topics":["latex","latex-template","letter","markdown-to-pdf","quarto","quarto-extension","quarto-template"],"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/juliantao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-02T22:01:33.000Z","updated_at":"2024-06-05T21:41:33.000Z","dependencies_parsed_at":"2024-08-03T22:05:33.977Z","dependency_job_id":"dfaa64e7-6f76-42b9-b0c9-b2ed3fe48ea2","html_url":"https://github.com/juliantao/qletter","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliantao%2Fqletter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliantao%2Fqletter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliantao%2Fqletter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliantao%2Fqletter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juliantao","download_url":"https://codeload.github.com/juliantao/qletter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228548559,"owners_count":17935226,"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":["latex","latex-template","letter","markdown-to-pdf","quarto","quarto-extension","quarto-template"],"created_at":"2024-08-03T22:01:04.412Z","updated_at":"2024-12-07T02:13:52.489Z","avatar_url":"https://github.com/juliantao.png","language":"TeX","funding_links":[],"categories":["Templates"],"sub_categories":["PDF Documents"],"readme":"# Opinioned Quarto letter template \n\nThis is a Quarto template that assists you in writing a letter.\n\nThe template is based on the LaTex `letter` class, with a customized layout including a logo at the upper left, a name block on the upper right, and an address block at the bottom left of the first page.\n\nThis template is the generic, quarto version of the [original `rmd` letter template](https://github.com/juliantao/bigrmd/tree/master/inst/rmarkdown/templates/Letter) for the ASU BiG research group.\nOriginal inspirations were drawn from [Rob Hyndman's MonashEBSTemplates](https://github.com/robjhyndman/MonashEBSTemplates/tree/master/inst/rmarkdown/templates/Letter). \nI also burrowed some ideas from the [quarto-letter extension](https://github.com/mcanouil/quarto-letter).\n\n## Creating a New Letter\n\nYou can use this as a template to create a letter with the ASU default. To do this, use the following command:\n\n```bash\nquarto use template juliantao/qletter\n```\n\nThis will install the extension and create an example qmd file. You'll need to modify the various fields in the YAML header and replace the placeholder logo with your own logo. \n\n## Installation For Existing Document\n\nYou may also use this format with an existing Quarto project or document. \nFrom the quarto project or document directory, run the following command to install this format:\n\n```bash\nquarto install extension juliantao/qletter\n```\n\n## Usage\n\nTo use the format, you can use the format names `qletter-pdf`. For example:\n\n```bash\nquarto render letter.qmd --to qletter-pdf\n```\n\nor in your document yaml\n\n```yaml\nformat: qletter-pdf\n```\n\nAfter rendering, the pdf file will be saved to the `_output` folder.\n\nA rendered file can be found [here](https://github.com/juliantao/qletter/blob/main/_output/qletter.pdf).\n\n![Screenshot](./screenshot.png)\n\n## YAML header and logo file \n\n```yaml\n---\nfromname: Sender name\nfromqualifications: PhD\nfromtitle: Professor\nfromWWW: sender.com\nfromemail: sender@sender.com\nfromphone: (000) 000 000\nfromdepartment: Sender Department \nfrominstitute: Sender Institution \nfromaddress: Sender Address in one line \nfromsignature: signature\nfromlogo: logo\ntoname: Recipient\ntoaddress: |\n  | Recipient address line 1 \n  | Recipient address line 2\nsubject: Subject Line\nopening: Dear Recipient, \nclosing: Best regards,\ncc:\n  - CC 1 \n  - CC 2\nencl:\n  - Enclosure 1\n  - Enclosure 2\nps: |\n  p.s.: something else \nspacing: 1.2\nformat: qletter-pdf\n---\n\n```\n\n1. Sender fields starts with `from`\n2. Recipient fields starts with `to`\n3. You can also set a different `fontfamily`,  `fontsize`, and `spacing`. The default fontfamily is `Roboto` and the size is `12pt`\n4. The `fromWWW` field is your website **without the starting string of `https://`**\n5. Save a copy of your logo and signature files in the directory, **please use a pdf format**\n6. The recipient's address can have more than two lines in the `toaddress` field, just add more lines with the syntax `- address`\n7. `cc`, `encl`, and `ps` fields are optional.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliantao%2Fqletter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuliantao%2Fqletter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliantao%2Fqletter/lists"}