KO
|
EN
gitlite — search
Search
#typescript
#ai-agents
#ai
#dsh-plugin
#deepseek-harness
#open-source
#cli
#claude-code
#codex
#developer-tools
#react
#windows
typst
★ 320
Open GitHub ↗
Easily create beautiful preprints in Typst
Download README (.md)
Explore Similar Repositories
ionic-audio
:
An audio player for Ionic 3 and Angular 4. Works with HTML 5 audio or native audio using Cordova Media plugin.
cronv
:
A visualizer for CRONTAB
mqttMultimeter
:
Cross platform MQTT client for MQTT debugging and message inspection. It is based on the .NET library MQTTnet.
dockyard
:
A fast & beautiful Docker GUI client
ruoyi-plus-soybean
:
RuoYi-Plus-Soybean 是一个现代化的企业级多租户管理系统，它结合了 RuoYi-Vue-Plus 的强大后端功能和 Soybean Admin 的现代化前端特性，为开发者提供了完整的企业管理解决方案。
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
typst
?
Download (.md)
<h1 align="center">LaPreprint for Typst</h1> <p align="center"> <a href="https://github.com/rowanc1/LaPreprint/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/github/license/rowanc1/lapreprint?style=flat-square"></a> <a href="https://github.com/rowanc1/lapreprint"><img alt="Stars" src="https://img.shields.io/github/stars/rowanc1/lapreprint?style=social"></a> <a href="https://twitter.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2Frowanc1%2FLaPreprint&via=rowancockett&text=Checkout%20the%20LaPreprint%20template%20for%20Typst"><img alt="Twitter" src="https://img.shields.io/twitter/follow/rowancockett"></a> </p> <p align="center"> <b>Easily create beautiful preprints in Typst</b> </p> <p align="center"> <img width="75%" src="https://raw.githubusercontent.com/rowanc1/LaPreprint/68f5ccbf1e1e26819149bcea1d547dfdfc5ceecd/example/files/screenshot.png"> </p> ```typst #import "lapreprint.typ": template #show: template.with( title: "A beautiful preprint template" ) ``` # Features With simple options you can enable/disable: - color schemes of blue, red, purple - author, ORCID, and affiliation support - branding and logo support - left margin with custom headings - date accepted, published & submitted - customizable font choices - running title, affiliation - multiple abstracts, e.g. plain language summary or english/french! - keywords, page count, nice headings - easily customize APA or IEEE citation style - Optional: full width after first page # Quick start The preprint template uses Typst (not LaTeX[^latex]) for typesetting, see [typst docs](https://typst.app/docs). [^latex]: If you are looking for LaPreprint for LaTeX, please see: https://github.com/roaldarbol/LaPreprint Copy [`lapreprint.typ`](./lapreprint.typ) to your own folder that you are working in, you only need the single `lapreprint.typ` file: ```typst #import "lapreprint.typ": template ``` Take a look at the examples in the [GitHub repository](https://github.com/rowanc1/LaPreprint), for example, [this file](https://github.com/rowanc1/lapreprint/blob/main/examples/pixels/main.typ#L5), the basics are to use the template with a `#show` command: ```typst #show: template.with( title: "A beautiful preprint template" // ... all sorts of other options that are explained below! ) ``` ## Logos and Branding The theme of the document can be set to a specific color, which changes the headers and links. The default `theme` is blue, however, the following examples use: ```typst theme: red.darken(50%), ``` You can also supply a logo, which is either an image file location or content, allowing you to add additional information about the journal or lab-group to the top-right of the document. You can also set the `paper-size`, `heading-numbering` and `font-face`. The default font-face used is Noto Sans, which you may need to [download](https://fonts.google.com/noto/specimen/Noto+Sans). ```typst logo: "my-logo.png", theme: purple.darken(20%), paper-size: "us-letter", heading-numbering: "1.a.i", font-face: "Noto Sans", ```  ## Title and Subtitle You can have both a title and a subtitle: ```typst title: "Pixels and their Neighbours", subtitle: "A Tutorial on Finite Volume", ``` Will become:  ## Authors and Affiliations You can add both author and affiliations lists, each author should have a `name`, and can optionally add `orcid`, `email`, and `affiliations`. The affiliations are just content that is put in superscript, e.g. `"1,2"`, have corresponding identifiers in the top level `affiliations` list, which requires both an `id` and a `name`. If you wish to include any additional information in the affiliation (e.g. an address, department, etc.), it is content and can have whatever you want in it. ```typst authors: ( ( name: "Rowan Cockett", orcid: "0000-0002-7859-8394", email: "rowan@curvenote.com", affiliations: "1,2" ), // Add other authors here... ), affiliations: ( (id: "1", name: "University of British Columbia"), (id: "2", name: "Curvenote Inc."), ), ```  Note that the orcid and email icons are actually aligned to the text. Details, details! For other information that you wish to affiliate with a specific author, you can use the `affiliations` field with any identifier you like (e.g. `†`) and then use the margin content or affiliations fields on the preprint to explain what it means. ## Abstract and Keywords You can include one or more abstracts as well as keywords. For a simple `abstract` the default title used is "Abstract" and you can include it with: ```typst abstract: lorem(100), keywords: ("Finite Volume", "Tutorial", "Reproducible Research"), ``` To include one or more specific abstracts, for example, different languages or a "Plain Language Summary", provide a list, with `title` and `content` in a dictionary: ```typst abstract: ( (title: "Abstract", content: lorem(100)), (title: "Plain Language Summary", content: lorem(25)), ), ```  ## Margin content The content on the first page is customizable. The first content is the `kind`, for example, "Original Research", "Review Article", "Retrospective" etc. And then the `date`, which is by default the date you compiled the document. ```typst kind: "Notebook Tutorial", date: datetime(year: 2023, month: 08, day: 21), ``` You can also set `date` to be a dictionary or list of dictionaries with `title` and `date` as the two required keys. The first date will be bolded as well as used in the document metadata and auto `short-citation`. ```typst kind: "Notebook Tutorial", date: ( (title: "Published", date: datetime(year: 2023, month: 08, day: 21)), (title: "Accepted", date: datetime(year: 2022, month: 12, day: 10)), (title: "Submitted", date: datetime(year: 2022, month: 12, day: 10)), ), ```  The rest of the margin content can be set with `margin` property, which takes a `title` and `content`, content is required, however the title is optional. ```typst margin: ( ( title: "Correspondence to", content: [ Rowan Cockett\ #link("mailto:rowan@curvenote.com")[rowan\@curvenote.com] ], ), // ... other properties ) ``` You can use the margin property for things like funding, data availability statements, explicit correspondence requests, key points, conflict of interest statements, etc.  ### Setting the Margin The first page has a left hand margin of 25%, if you do nothing this will continue for your whole document. To override this, you can reset the margin after the first page by placing `#set page(margin: auto)` in a place where you want the page break between the first and second pages[^margin]. If you opt for resetting to a full-width margin, you will want to not supply a `bibliography-file` to the template, and instead do this in your content, this is because the template will revert to the first-page margin as well as inserting a page break[^bug]. See the section on bibliography below. [^margin]: If you know a better way of doing this to automate it in the template, please open an issue or pull-request!! [^bug]: This seems like a bug to me in typst, but maybe is by design? ## Headers and Footers You can control the headers and footer by providing the following information: ```typst open-access: true, doi: "10.1190/tle35080703.1", venue: [ar#text(fill: red.darken(20%))[X]iv], short-title: "Finite Volume Tutorial", short-citation: auto, date: datetime.today() ``` The first page will show an open-access statement and the `doi` if available. For DOIs, only include the actual identifier, not the URL portions:  Subsequent pages will show the `short-title` and `short-citation`. If the citation is `auto` (the default) it will be created in APA formatting using the paper authors.  The footers show the `venue` (e.g. the journal or preprint repository) the `date` (which is by default `today()`) as well as the page count.  ## Bibliography The bibliography is only included in the theme if you supply the `bibliography-file` and an optional `bibliography-style`. The default `bibliography-style` is `"apa"`, you can override this if you like, for example, to `"ieee"`. If you have opted for full-page margins or have an appendix, you may want to place the bibliography yourself as including in the template will default back to the same margin as the first page. You can also handle the bibliography yourself with: ```typst #{ show bibliography: set text(8pt) bibliography("main.bib", title: text(10pt, "References"), style: "apa") } ``` # Acknowledgements The Typst LaPreprint template (and this Readme!) is inspired by [@roaldarbol LaTeX template](https://github.com/roaldarbol/LaPreprint), which is in the style of eLife and PLoS. Portions of the template were based on the example IEEE template in Typst.
