{"id":13858928,"url":"https://github.com/thomaspark/pubcss","last_synced_at":"2026-01-27T17:36:37.207Z","repository":{"id":26068709,"uuid":"29512416","full_name":"thomaspark/pubcss","owner":"thomaspark","description":"Format academic publications in HTML \u0026 CSS","archived":false,"fork":false,"pushed_at":"2024-04-22T18:09:13.000Z","size":5412,"stargazers_count":798,"open_issues_count":21,"forks_count":78,"subscribers_count":32,"default_branch":"master","last_synced_at":"2025-03-10T15:16:48.133Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://thomaspark.co/2015/01/pubcss-formatting-academic-publications-in-html-css/","language":"SCSS","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/thomaspark.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}},"created_at":"2015-01-20T04:52:16.000Z","updated_at":"2025-02-16T20:08:09.000Z","dependencies_parsed_at":"2023-01-14T03:58:21.376Z","dependency_job_id":null,"html_url":"https://github.com/thomaspark/pubcss","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thomaspark%2Fpubcss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thomaspark%2Fpubcss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thomaspark%2Fpubcss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thomaspark%2Fpubcss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thomaspark","download_url":"https://codeload.github.com/thomaspark/pubcss/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244022628,"owners_count":20385133,"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":[],"created_at":"2024-08-05T03:02:26.374Z","updated_at":"2026-01-27T17:36:37.157Z","avatar_url":"https://github.com/thomaspark.png","language":"SCSS","readme":"# PubCSS\n\nPubCSS is a library of CSS stylesheets and HTML templates for formatting academic publications for print and the web.\n\nCurrently, the following formats are supported:\n\n* [ACM SIG Proceedings](http://www.acm.org/sigs/publications/proceedings-templates)\n* [ACM SIGCHI Conference Papers](http://www.sigchi.org/publications/chipubform)\n* [ACM SIGCHI Extended Abstracts](http://www.sigchi.org/publications/chipubform)\n* [IEEE Conference Proceedings](http://www.ieee.org/conferences_events/conferences/publishing/templates.html)\n\nCheck out sample output [here](http://thomaspark.me/2015/01/pubcss-formatting-academic-publications-in-html-css/).\n\n\n## Quick Start\n\n1. Create an HTML file, or modify the relevant template, to add your content\n2. Link your HTML to the relevant `pub.css` stylesheet\n3. Build to PDF using Prince with the command `prince input.html output.pdf`\n\nThe only dependency is [Prince](http://www.princexml.com/), which is free for non-commercial use.\n\n## Reference\n\n### Sections\n\nSections and subsections are automatically numbered by following this pattern.\n\n\n```html\n\u003ch1\u003eSection Header\u003c/h1\u003e\n\u003csection\u003e\n  \u003ch2\u003eSubsection Header\u003c/h2\u003e\n  \u003cp\u003eLorem ipsum\u003c/p\u003e\n\u003c/section\u003e\n```\n\n### Tables and Figures\n\nFigures and tables are also numbered if you include a caption.\n\n```html\n\u003ctable\u003e\n  \u003ctr\u003e\u003ctd\u003e1\u003c/td\u003e\u003ctd\u003e2\u003c/td\u003e\u003c/tr\u003e\n  \u003ccaption\u003eExample Table\u003c/caption\u003e\n\u003ctable\u003e\n\n\u003cfigure\u003e\n  \u003cimg src=\"graph.png\"\u003e\n  \u003cfigcaption\u003eExample Figure\u003c/figcaption\u003e\n\u003c/figure\u003e\n```\n\n### References and Citations\n\nReferences are also numbered. Be sure to assign them unique IDs.\n\n```html\n\u003ccite id=\"nicole\"\u003eNicole. 2015. Title of paper. \u003cem\u003eJournal\u003c/em\u003e, 4(3), 1-10.\u003c/cite\u003e\n```\n\nCitations to the references make use of these IDs.\n\n```html\n\u003ca href=\"#nicole\"\u003e\u003c/a\u003e\n```\n\nMultiple citations can be made in one set of brackets.\n\n```html\n\u003cspan class=\"cites\"\u003e\u003ca href=\"#beeker\"\u003e\u003c/a\u003e\u003ca href=\"#jackie\"\u003e\u003c/a\u003e\u003ca href=\"#kiwi\"\u003e\u003c/a\u003e\u003c/span\u003e\n```\n\nSections, tables, and figures can also be referenced by adding a class.\n\n```html\n\u003ca href=\"#intro\" class=\"section\"\u003e\u003c/a\u003e\n\u003ca href=\"#example-table\" class=\"table\"\u003e\u003c/a\u003e\n\u003ca href=\"#example-figure\" class=\"figure\"\u003e\u003c/a\u003e\n```\n\n### Equations\n\nEquations are also numbered. MathML is well-supported by Prince. For the web, you’ll need [MathJax](http://www.mathjax.org/) to render MathML properly in Chrome and Internet Explorer.\n\n```html\n\u003cdiv class=\"equation\"\u003e\n  \u003cmath xmlns=\"http://www.w3.org/1998/Math/MathML\"\u003e\n    \u003cmi\u003eE\u003c/mi\u003e\n    \u003cmo\u003e=\u003c/mo\u003e\n    \u003cmi\u003em\u003c/mi\u003e\n    \u003cmsup\u003e\n      \u003cmi\u003ec\u003c/mi\u003e\n      \u003cmn\u003e2\u003c/mn\u003e\n    \u003c/msup\u003e\n  \u003c/math\u003e\n\u003c/div\u003e\n```\n\n### Footnotes\n\nFootnotes are made within the body text, and are automatically moved to the bottom of the current page.\n\n```html\n\u003cp\u003eThis is text.\u003cspan class=\"footnote\"\u003eAnd this is a footnote.\u003c/span\u003e\u003c/p\u003e\n```\n\n### Smart Quotes\n\nSmart quotes can be used in lieu of straight quotes by enclosing the text like so. You can nest quotes within quotes.\n\n```html\n\u003cq\u003eTo be or not be.\u003c/q\u003e\n```\n\n### Utility Classes\n\nUtility classes are also available to modify layout and counter behavior.\n\n* `col-2`: divide the element into 2 columns\n* `col-3`: divide the element into 3 columns\n* `col-4`: divide the element into 4 columns\n* `col-span`: span all of the columns of parent\n* `col-break-before`: force column break before element\n* `col-break-after`: force column break after element\n* `page-break-before`: force page break before element\n* `page-break-after`: force page break after element\n* `counter-skip`: do not count this header\n* `counter-reset`: reset counter to 0\n\n## Customization\n\nOne of the major advantages of PubCSS is that you can use CSS to customize the style. All of the usual rules apply.\n\nTo create a new theme, you’ll want to dig into the LESS source. The most common changes can be made through `variables.less`, such as toggling page numbers and setting counter styles. The rest can be included in `custom.less`.\n","funding_links":[],"categories":["SCSS"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthomaspark%2Fpubcss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthomaspark%2Fpubcss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthomaspark%2Fpubcss/lists"}