{"id":13477379,"url":"https://github.com/wjschne/apaquarto","last_synced_at":"2026-01-17T16:52:50.917Z","repository":{"id":164971878,"uuid":"613050042","full_name":"wjschne/apaquarto","owner":"wjschne","description":"A quarto extension for creating APA7 documents in .docx, .html, and .pdf formats","archived":false,"fork":false,"pushed_at":"2025-10-17T13:00:46.000Z","size":4267,"stargazers_count":218,"open_issues_count":13,"forks_count":19,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-10-18T16:08:53.560Z","etag":null,"topics":["apa-style","lua-filter","quarto","quarto-extension","quarto-template"],"latest_commit_sha":null,"homepage":"https://wjschne.github.io/apaquarto/","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wjschne.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.qmd","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-12T18:35:11.000Z","updated_at":"2025-10-17T13:00:49.000Z","dependencies_parsed_at":"2024-01-20T16:23:22.629Z","dependency_job_id":"29e0d200-e399-4c73-bdb1-336f48b2d06c","html_url":"https://github.com/wjschne/apaquarto","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wjschne/apaquarto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wjschne%2Fapaquarto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wjschne%2Fapaquarto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wjschne%2Fapaquarto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wjschne%2Fapaquarto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wjschne","download_url":"https://codeload.github.com/wjschne/apaquarto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wjschne%2Fapaquarto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28511874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["apa-style","lua-filter","quarto","quarto-extension","quarto-template"],"created_at":"2024-07-31T16:01:41.951Z","updated_at":"2026-01-17T16:52:50.857Z","avatar_url":"https://github.com/wjschne.png","language":"Lua","funding_links":[],"categories":["Lua"],"sub_categories":[],"readme":"# A Quarto Extension for Creating APA 7 Style Documents\n\n\n\u003cimg loading=\"lazy\" alt=\"any text: you like\" src=\"https://img.shields.io/badge/lifecycle-experimental-orange\"\u003e\n\nThis article template creates [APA Style 7th Edition\ndocuments](https://apastyle.apa.org/) in .docx, .html. and .pdf. The\n.pdf format can be rendered via Latex (i.e., apaquarto-pdf) or via Typst\n(apaquarto-typst). The Typst output for this extension is still\nexperimental and requires Quarto 1.5 or greater.\n\nBecause the .docx format is still widely used—and often required—my main\npriority was to ensure compatibility for .docx. This is still a work in\nprogress, and I encourage filing a “New Issue” on GitHub if something\ndoes not work of if there is a feature missing.\n\nSee [instructions and template options for apaquarto\nhere](https://wjschne.github.io/apaquarto/).\n\n[Version History](https://wjschne.github.io/apaquarto/changelog.html)\n\n## Example Outputs\n\nThe apaquarto-docx form looks like this:\n\n![Preview of .docx output](img/docx.png)\n\nThe .html and .pdf output (in manuscript mode) look similar. The .pdf in\njournal mode looks like this:\n\n![Preview of .pdf output in journal mode](img/journalmode.png)\n\n## Creating a New Article\n\nYou can create a new article with apaquarto’s template file. There are\ntwo ways to do so.\n\n1.  Via the R console\n2.  Via the terminal\n\nIf you are an R user, you might prefer the R console method. Anyone,\nincluding R users, can use the second method.\n\n### Using R via the R Console\n\nIf you are an R user, you can install extensions with the [quarto\npackage](https://quarto-dev.github.io/quarto-r/) (version = 1.4 or\nhigher). The quarto package is not Quarto itself, but it provides\nconvenient functions to interact with Quarto.\n\nIf the quarto package is not installed, you can can install it by\nrunning this code in the console:\n\n``` r\n# latest release version \ninstall.packages(\"quarto\")\n```\n\nOnce the quarto package is installed, you can install a quarto extension\ntemplate by setting your working directory to the folder where you want\nthe template to be installed (e.g., `setwd(\"path/to/my/folder\")`) and\nthen running this:\n\n``` r\nquarto::quarto_use_template(\"wjschne/apaquarto\")\n```\n\nA prompt will ask if you trust the author (me) not to run malicious\ncode. To proceed, answer `Yes` or just `Y`.\n\n### Using the Terminal\n\nIf you are not an R user, you can create a new article directly in the\nterminal. Navigate to the folder where you want to create your file\n(e.g., `cd path/to/my/folder`), and run this command:\n\n``` bash\nquarto use template wjschne/apaquarto\n```\n\nIn RStudio, the terminal is in a tab next to the console. If you cannot\nsee a terminal tab next to the console, use the keyboard shortcut\nAlt-Shift-R to make a terminal appear.\n\nEntering the command above will prompt a question about whether you\ntrust the author of the extension to not run malicious code. If you\nanswer Yes, you will be prompted to name a new folder where the\nextension will be installed.\n\n## Template file\n\nAfter installation, you will see a template file in the folder you\nselect. The template file will have the same name as the folder you\ninstalled the template to and ends with `.qmd`. This file has most of\nthe options already filled out and explains how and why to change them.\nIt also has a examples of how to use the extension in the text.\n\nIf you prefer a minimal template, you can start with the `minimal.qmd`\nfile instead.\n\n## Adding apaquarto to an Existing Document or Project\n\nYou can add the apaquarto extension to an existing file or project in\none of two ways:\n\n1.  Via the R console\n2.  Via the terminal\n\n### Creating a New Document Via the R console\n\nIf you are an R user, you can install extensions with the [quarto\npackage](https://quarto-dev.github.io/quarto-r/) (version = 1.4 or\nhigher). The quarto package is not Quarto itself, but it provides\nconvenient functions to interact with Quarto.\n\nIf the quarto package is not installed, you can can install it by\nrunning this code in the console:\n\n``` r\n# latest release version \ninstall.packages(\"quarto\")\n```\n\nIn RStudio, open the project that contains the file to which you want to\nadd apaquarto. If your file is not part of a project, set the working\ndirectory to the same folder as the file (e.g.,\n`setwd(\"path/to/my/folder\")`).\n\nRun this code in the console:\n\n``` r\nquarto::quarto_use_template(\"wjschne/apaquarto\")\n```\n\n### Creating a New Document Via the Terminal\n\nTo add this format to an existing document, navigate to the folder where\nthe existing .qmd you wish to use and then run:\n\n``` bash\nquarto add wjschne/apaquarto\n```\n\n### Add apaquarto to the Document’s Metadata:\n\nYou can select one of three formats: .docx, .pdf, or .html. When\nwriting, I prefer to output to .html, because it renders quickly. Then I\nswitch to .docx or .pdf, depending on where I need to submit the paper.\n\nYou can add all of these formats or any combination of them:\n\n``` yaml\nformat:\n  apaquarto-docx: default\n  apaquarto-html: default\n  apaquarto-pdf: default\n  apaquarto-typst: default\n```\n\nHere is a minimal example of what the YAML metadata might look like:\n\n``` yaml\n---\ntitle: \"My Paper's Title: A Full Analysis of Everything\"\nshorttitle: \"My Paper's Title\"\nauthor:\n  - name: W. Joel Schneider\n    corresponding: true\n    orcid: 0000-0002-8393-5316\n    email: schneider@temple.edu\n    affiliations:\n      - name: Temple University\n        department: College of Education and Human Development\n        address: 1301 Cecil B. Moore Ave.\n        city: Philadelphia\n        region: PA\n        postal-code: 19122-6091\nabstract: \"This is my abstract.\"\nkeywords: [keyword1, keyword2]\nauthor-note:\n  disclosures:\n    conflict of interest: The author has no conflict of interest to declare.\nbibliography: mybibfile.bib     \nformat:\n  apaquarto-docx: default\n  apaquarto-html: default\n  apaquarto-pdf: default\n  apaquarto-typst: default\n---\n```\n\n## Updating to the latest version of apaquarto\n\nIn the terminal, run\n\n``` bash\nquarto update wjschne/apaquarto\n```\n\n## Removing apaquarto\n\nIn the terminal, run\n\n``` bash\nquarto remove wjschne/apaquarto\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwjschne%2Fapaquarto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwjschne%2Fapaquarto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwjschne%2Fapaquarto/lists"}