[package]
name = "modern-mla"
version = "0.1.0"
entrypoint = "template.typ"
authors = ["Dzming Li <i@dzmingli>"]
license = "MIT"
categories = ["paper", "report"]
repository = "https://nest.pijul.com/DzmingLi/typst-mla-template"
description = "Template for MLA formats" 
keywords = ["MLA"]
[template]
path = "template"
entrypoint = "main.typ"
thumbnail = "thumbnail.png"

#let mla(
  title: "Paper Title",
  author: none,
  professor: none,
  date: none,
  course: none,
  bibliography-file: none,
  body
) = {
  // Set document metdata.
  set document(
    title: title,
    author: author.firstname + " " + author.lastname
  )
  
  // Configure the page.
  set page(
    paper: "us-letter",
    header: align(
      right + horizon,
      [
        #v(0.5in)
        #author.lastname
        #context(counter(page).display("1"))
      ]
    ),
    margin: 1in
  )
  
  // Set paragraph properties.
  set par(
    first-line-indent: 0.5in,
    justify: false, 
    leading: 2em
  )
  set par( 
    spacing: 2em 
  )
  // Set the body font.
  set text(
    font: "Liberation Serif",
    size: 12pt,
  )
  // Configure headings.
  set heading(numbering: "1.1.a.")
  show heading: set block(spacing: 2em)
  show heading: it => {
    set text(size: 12pt)
    set par(first-line-indent: 0in)
    
    // Create the heading numbering.
    let number = if it.numbering != none {
      counter(heading).display(it.numbering)
      h(6pt, weak: true)
    }
    
    // Don't number the conclusion
    let is-conclusion = it.body in ([conclusion], [Conclusion], [CONCLUSION])
    v(2em)
    if it.level == 1 and is-conclusion == true {
      block[#text(weight: "bold")[#it.body]]
    } else if it.level == 1 and is-conclusion == false {
      block[#text(weight: "bold")[#number #it.body]]
    } else if it.level == 2 {
      block[#text(weight: "semibold")[#number #it.body]]
    } else if it.level == 3 {
      block[#text(weight: "medium")[#number #it.body]]
    }
    v(2em)
  }
  // configure block quotes
  set quote(block: true)
  show quote: set pad(left: 0.5in)
  show quote: set block(spacing: 2em)
  // configure tables
  show figure.where(kind: table): it => {
    set block(spacing: 1em)
    set par(
      first-line-indent: 0in,
      leading: 1em
    )
    set table(stroke: none, align: center, row-gutter: 1em)
    strong([Table #it.counter.display(it.numbering) #linebreak()])
    it.caption.body
    it.body
    it.supplement
  }
  // configure illustrations
  show figure.where(kind: image): it => {
    set block(spacing: 1em)
    set par(
      first-line-indent: 0in,
      leading: 1em
    )
    it.body
     align(
       center,
       [Fig. #it.counter.display(it.numbering)\. #it.caption.body]
     )
    
  }
  // MLA boilerplate
  align(left,
    stack(
      dir:ttb,
      spacing: 2em,
      [#author.firstname #author.lastname],
      ..if professor != none { (professor,) } else { () },
      course,
      date
    )
  )
  
  // Display the paper's title.
  align(center, title)
  // Display the paper's contents.
  body
  // Display the bibliography, if any is given.
  if bibliography-file != none {
    pagebreak()
    align(center, "Works Cited")
    show bibliography: set par(
      first-line-indent: 0in,
      hanging-indent: 0.5in
    )
    bibliography(
      bibliography-file, title:none, style: "mla"
    )
  }
}

#import "@preview/modern-mla:0.1.0":*
#show: mla.with(
  title: "",
  author: (
    firstname: "",
    lastname: ""
  ),
  professor:none,
  course:[], 
  date: [],
  bibliography-file: none,
)

# modern-mla
A typst template for use in MLA formats.
## Usage
### Method 1: Using typst init (Recommended)
Initialize a new project using this template:
```bash
typst init @preview/modern-mla
```
Or specify a custom directory name:
```bash
typst init @preview/modern-mla my-paper
```
### Method 2: Manual import
Import the template in your Typst document:
```typst
#import "@preview/modern-mla:0.1.0": *
#show: mla.with(
  title: "Your Paper Title",
  author: "Your Name",
  professor: "Professor Name",
  course: "Course Name",
  date: datetime.today(),
)
// Your content here
```

MIT License
Copyright (c) 2024 wych(witch)
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, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
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.