charged-ieee:0.1.4 and wonderous-book:0.1.2

packages/preview/charged-ieee/0.1.4/LICENSE

@@ -0,0 +1,14 @@
+MIT No Attribution
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this
+software and associated documentation files (the "Software"), to deal in the Software
+without restriction, including without limitation the rights to use, copy, modify,
+merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

packages/preview/charged-ieee/0.1.4/README.md

@@ -0,0 +1,73 @@
+# charged-ieee
+This is a Typst template for a two-column paper from the proceedings of the
+Institute of Electrical and Electronics Engineers. The paper is tightly spaced,
+fits a lot of content and comes preconfigured for numeric citations from
+BibLaTeX or Hayagriva files.
+
+## Usage
+You can use this template in the Typst web app by clicking "Start from template"
+on the dashboard and searching for `charged-ieee`.
+
+Alternatively, you can use the CLI to kick this project off using the command
+```
+typst init @preview/charged-ieee
+```
+
+Typst will create a new directory with all the files needed to get you started.
+
+## Configuration
+This template exports the `ieee` function with the following named arguments:
+
+- `title`: The paper's title as content.
+- `authors`: An array of author dictionaries. Each of the author dictionaries
+  must have a `name` key and can have the keys `department`, `organization`,
+  `location`, and `email`. All keys accept content.
+- `abstract`: The content of a brief summary of the paper or `none`. Appears at
+  the top of the first column in boldface.
+- `index-terms`: Array of index terms to display after the abstract. Shall be
+  `content`.
+- `paper-size`: Defaults to `us-letter`. Specify a [paper size
+  string](https://typst.app/docs/reference/layout/page/#parameters-paper) to
+  change the page format.
+- `bibliography`: The result of a call to the `bibliography` function or `none`.
+  Specifying this will configure numeric, IEEE-style citations.
+- `figure-supplement`: How figures are referred to from within the text. Use
+  `"Figure"` instead of `"Fig."` for computer-related publications.
+
+The function also accepts a single, positional argument for the body of the
+paper.
+
+The template will initialize your package with a sample call to the `ieee`
+function in a show rule. If you want to change an existing project to use this
+template, you can add a show rule like this at the top of your file:
+
+```typ
+#import "@preview/charged-ieee:0.1.4": ieee
+
+#show: ieee.with(
+  title: [A typesetting system to untangle the scientific writing process],
+  abstract: [
+    The process of scientific writing is often tangled up with the intricacies of typesetting, leading to frustration and wasted time for researchers. In this paper, we introduce Typst, a new typesetting system designed specifically for scientific writing. Typst untangles the typesetting process, allowing researchers to compose papers faster. In a series of experiments we demonstrate that Typst offers several advantages, including faster document creation, simplified syntax, and increased ease-of-use.
+  ],
+  authors: (
+    (
+      name: "Martin Haug",
+      department: [Co-Founder],
+      organization: [Typst GmbH],
+      location: [Berlin, Germany],
+      email: "[email protected]"
+    ),
+    (
+      name: "Laurenz Mädje",
+      department: [Co-Founder],
+      organization: [Typst GmbH],
+      location: [Berlin, Germany],
+      email: "[email protected]"
+    ),
+  ),
+  index-terms: ("Scientific writing", "Typesetting", "Document creation", "Syntax"),
+  bibliography: bibliography("refs.bib"),
+)
+
+// Your content goes below.
+```

packages/preview/charged-ieee/0.1.4/lib.typ

@@ -0,0 +1,241 @@
+// This function gets your whole document as its `body` and formats
+// it as an article in the style of the IEEE.
+#let ieee(
+  // The paper's title.
+  title: [Paper Title],
+
+  // An array of authors. For each author you can specify a name,
+  // department, organization, location, and email. Everything but
+  // but the name is optional.
+  authors: (),
+
+  // The paper's abstract. Can be omitted if you don't have one.
+  abstract: none,
+
+  // A list of index terms to display after the abstract.
+  index-terms: (),
+
+  // The article's paper size. Also affects the margins.
+  paper-size: "us-letter",
+
+  // The result of a call to the `bibliography` function or `none`.
+  bibliography: none,
+
+  // How figures are referred to from within the text.
+  // Use "Figure" instead of "Fig." for computer-related publications.
+  figure-supplement: [Fig.],
+
+  // The paper's content.
+  body
+) = {
+  // Set document metadata.
+  set document(title: title, author: authors.map(author => author.name))
+
+  // Set the body font.
+  // As of 2024-08, the IEEE LaTeX template uses wider interword spacing
+  // - See e.g. the definition \def\@IEEEinterspaceratioM{0.35} in IEEEtran.cls
+  set text(font: "TeX Gyre Termes", size: 10pt, spacing: .35em)
+
+  // Enums numbering
+  set enum(numbering: "1)a)i)")
+
+  // Tables & figures
+  show figure: set block(spacing: 15.5pt)
+  show figure: set place(clearance: 15.5pt)
+  show figure.where(kind: table): set figure.caption(position: top, separator: [\ ])
+  show figure.where(kind: table): set text(size: 8pt)
+  show figure.where(kind: table): set figure(numbering: "I")
+  show figure.where(kind: image): set figure(supplement: figure-supplement, numbering: "1")
+  show figure.caption: set text(size: 8pt)
+  show figure.caption: set align(start)
+  show figure.caption.where(kind: table): set align(center)
+
+  // Adapt supplement in caption independently from supplement used for
+  // references.
+  set figure.caption(separator: [. ])
+  show figure: fig => {
+    let prefix = (
+      if fig.kind == table [TABLE]
+      else if fig.kind == image [Fig.]
+      else [#fig.supplement]
+    )
+    let numbers = numbering(fig.numbering, ..fig.counter.at(fig.location()))
+    // Wrap figure captions in block to prevent the creation of paragraphs. In
+    // particular, this means `par.first-line-indent` does not apply.
+    // See https://github.com/typst/templates/pull/73#discussion_r2112947947.
+    show figure.caption: it => block[#prefix~#numbers#it.separator#it.body]
+    show figure.caption.where(kind: table): smallcaps
+    fig
+  }
+
+  // Code blocks
+  show raw: set text(
+    font: "TeX Gyre Cursor",
+    ligatures: false,
+    size: 1em / 0.8,
+    spacing: 100%,
+  )
+
+  // Configure the page and multi-column properties.
+  set columns(gutter: 12pt)
+  set page(
+    columns: 2,
+    paper: paper-size,
+    // The margins depend on the paper size.
+    margin: if paper-size == "a4" {
+      (x: 41.5pt, top: 80.51pt, bottom: 89.51pt)
+    } else {
+      (
+        x: (50pt / 216mm) * 100%,
+        top: (55pt / 279mm) * 100%,
+        bottom: (64pt / 279mm) * 100%,
+      )
+    }
+  )
+
+  // Configure equation numbering and spacing.
+  set math.equation(numbering: "(1)")
+  show math.equation: set block(spacing: 0.65em)
+
+  // Configure appearance of equation references
+  show ref: it => {
+    if it.element != none and it.element.func() == math.equation {
+      // Override equation references.
+      link(it.element.location(), numbering(
+        it.element.numbering,
+        ..counter(math.equation).at(it.element.location())
+      ))
+    } else {
+      // Other references as usual.
+      it
+    }
+  }
+
+  // Configure lists.
+  set enum(indent: 10pt, body-indent: 9pt)
+  set list(indent: 10pt, body-indent: 9pt)
+
+  // Configure headings.
+  set heading(numbering: "I.A.a)")
+  show heading: it => {
+    // Find out the final number of the heading counter.
+    let levels = counter(heading).get()
+    let deepest = if levels != () {
+      levels.last()
+    } else {
+      1
+    }
+
+    set text(10pt, weight: 400)
+    if it.level == 1 {
+      // First-level headings are centered smallcaps.
+      // We don't want to number the acknowledgment section.
+      let is-ack = it.body in ([Acknowledgment], [Acknowledgement], [Acknowledgments], [Acknowledgements])
+      set align(center)
+      set text(if is-ack { 10pt } else { 11pt })
+      show: block.with(above: 15pt, below: 13.75pt, sticky: true)
+      show: smallcaps
+      if it.numbering != none and not is-ack {
+        numbering("I.", deepest)
+        h(7pt, weak: true)
+      }
+      it.body
+    } else if it.level == 2 {
+      // Second-level headings are run-ins.
+      set text(style: "italic")
+      show: block.with(spacing: 10pt, sticky: true)
+      if it.numbering != none {
+        numbering("A.", deepest)
+        h(7pt, weak: true)
+      }
+      it.body
+    } else [
+      // Third level headings are run-ins too, but different.
+      #if it.level == 3 {
+        numbering("a)", deepest)
+        [ ]
+      }
+      _#(it.body):_
+    ]
+  }
+
+  // Style bibliography.
+  show std.bibliography: set text(8pt)
+  show std.bibliography: set block(spacing: 0.5em)
+  set std.bibliography(title: text(10pt)[References], style: "ieee")
+
+  // Display the paper's title and authors at the top of the page,
+  // spanning all columns (hence floating at the scope of the
+  // columns' parent, which is the page).
+  place(
+    top,
+    float: true,
+    scope: "parent",
+    clearance: 30pt,
+    {
+      {
+        set align(center)
+        set par(leading: 0.5em)
+        set text(size: 24pt)
+        block(below: 8.35mm, title)
+      }
+
+      // Display the authors list.
+      set par(leading: 0.6em)
+      for i in range(calc.ceil(authors.len() / 3)) {
+        let end = calc.min((i + 1) * 3, authors.len())
+        let is-last = authors.len() == end
+        let slice = authors.slice(i * 3, end)
+        grid(
+          columns: slice.len() * (1fr,),
+          gutter: 12pt,
+          ..slice.map(author => align(center, {
+            text(size: 11pt, author.name)
+            if "department" in author [
+              \ #emph(author.department)
+            ]
+            if "organization" in author [
+              \ #emph(author.organization)
+            ]
+            if "location" in author [
+              \ #author.location
+            ]
+            if "email" in author {
+              if type(author.email) == str [
+                \ #link("mailto:" + author.email)
+              ] else [
+                \ #author.email
+              ]
+            }
+          }))
+        )
+
+        if not is-last {
+          v(16pt, weak: true)
+        }
+      }
+    }
+  )
+
+  set par(justify: true, first-line-indent: (amount: 1em, all: true), spacing: 0.5em, leading: 0.5em)
+
+  // Display abstract and index terms.
+  if abstract != none {
+    set par(spacing: 0.45em, leading: 0.45em)
+    set text(9pt, weight: 700, spacing: 150%)
+
+    [_Abstract_---#h(weak: true, 0pt)#abstract]
+
+    if index-terms != () {
+      parbreak()
+      [_Index Terms_---#h(weak: true, 0pt)#index-terms.join[, ]]
+    }
+    v(2pt)
+  }
+
+  // Display the paper's contents.
+  body
+
+  // Display bibliography.
+  bibliography
+}