presentation.template

This repository contains latex templates for NumPEx documents

https://github.com/numpex/presentation.template

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.0%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

This repository contains latex templates for NumPEx documents

Basic Info
  • Host: GitHub
  • Owner: numpex
  • Language: TeX
  • Default Branch: main
  • Size: 27.4 MB
Statistics
  • Stars: 0
  • Watchers: 15
  • Forks: 1
  • Open Issues: 0
  • Releases: 3
Created over 1 year ago · Last pushed 11 months ago
Metadata Files
Readme Citation

README.md

A Beamer Template for NumPEx Presentations

DOI GitHub Release Slack Slack

Getting Started

Just clone the repository, add the path to your TEXINPUTS environment variable, and you are ready to use the theme in your presentation by adding:

latex \usetheme{numpex}

Slides template

Checkout presentation.template.tex:

shell bash a.cli build presentation.template.tex

Poster template

Checkout poster.template.tex:

shell bash a.cli build poster.template.tex

Fonts

For a better result, you should install the Marianne font and compile with XeTeX.

Installing Marianne Fonts

  1. Download the Fonts:

    • You can download the Marianne fonts using the provided a.cli script. Run the following command: bash bash a.cli installfonts
    • This will download and extract the Marianne fonts into the fonts/ directory within your project.
  2. Configure LaTeX:

    • Ensure your LaTeX configuration points to the fonts/ directory. The provided beamerfontthemenumpex package is already configured to use the relative path fonts/.

CI/CD Pipeline

This repository includes a GitHub Actions workflow to compile the LaTeX document and release the PDF artifact. The workflow is triggered on pushes to branches and tags.

Workflow Steps

  1. Workflow Setup:

    • Determines the appropriate runner (ubuntu-latest or self-texlive) based on the availability of a self-hosted runner with the self-texlive label.
  2. Build LaTeX:

    • Compiles the LaTeX document using latexmk and xelatex.
    • Renames the generated PDF to include the branch or tag name.
  3. Check:

    • Downloads the artifact and verifies that the LaTeX document compiles correctly from the artifact.
  4. Release:

    • Creates a GitHub release for tagged commits (e.g., v1.0.0).
    • Uploads the PDF and other relevant files as release assets.

Usage

  • Setup Hooks: bash bash a.cli setup

  • Create a Release: bash bash a.cli create v1.0.0

  • List Releases: bash bash a.cli list

  • Compile the Document: bash bash a.cli build your_document.tex

Contributing

Feel free to open issues or submit pull requests for improvements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for details. ```

Owner

  • Name: NumPEx
  • Login: numpex
  • Kind: organization
  • Location: France

French Exascale Research Initiative

Citation (CITATION.cff)

cff-version: 1.2.0 
message: If you use this software, please cite it as below.
authors:
- family-names: Buttari
  given-names: Alfredo
  orcid: 'https://orcid.org/0000-0003-3207-7021'
  affiliation: "Institut de Recherche en Informatique de Toulouse"
  email: alfredo.buttari@irit.fr
- family-names: Prud'homme
  given-names: Christophe
  orcid: 'https://orcid.org/0000-0003-2287-2961'
  affiliation: "University of Strasbourg"
  email: christophe.prudhomme@cemosis.fr
title: "numpex/presentation.template - Template repository for presentations"
version: 1.0.1
abstract: >
  This repository contains a LaTeX style for presentations in
  the context of the French initiative for Exascale
  computing NumPEx.

keywords:
  - Presentation
  - Template
  - NumPEx
license: CC-BY-4.0
identifiers:
  - type: doi
    value: 10.5281/zenodo.13343692
date-released: 2024-08-19
url: "https://github.com/numpex/presentation.template"
references:
  - type: grant
    institution: French National Research Agency
    number: ANR-22-EXNU-0003
  - type: grant
    institution: French National Research Agency
    number: ANR-22-EXNU-0002

GitHub Events

Total
  • Create event: 3
  • Issues event: 4
  • Release event: 1
  • Delete event: 2
  • Issue comment event: 2
  • Push event: 17
  • Pull request review comment event: 1
  • Pull request review event: 8
  • Pull request event: 4
  • Fork event: 1
Last Year
  • Create event: 3
  • Issues event: 4
  • Release event: 1
  • Delete event: 2
  • Issue comment event: 2
  • Push event: 17
  • Pull request review comment event: 1
  • Pull request review event: 8
  • Pull request event: 4
  • Fork event: 1

Dependencies

.github/workflows/latex.yml actions
  • actions/checkout v4 composite
  • actions/download-artifact v4 composite
  • actions/upload-artifact v4 composite
  • softprops/action-gh-release v2 composite
  • xu-cheng/latex-action v3 composite
.github/workflows/release.yml actions
  • actions/checkout v4 composite