Skip to content

Commit

Permalink
build on main only
Browse files Browse the repository at this point in the history
  • Loading branch information
MoustafaAMahmoud committed Jun 4, 2024
1 parent f820ff2 commit b81dc86
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 73 deletions.
99 changes: 26 additions & 73 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,95 +1,48 @@
# Garage Education Presentation Template
# <img src="./logos/header_logo.png" width="30" height="30"/> Garage Education Presentation Template

This repository contains a LaTeX Beamer template for creating educational presentations. The template is designed to be simple and minimalistic, yet professional and engaging.

## Getting Started
## <img src="https://img.icons8.com/color/30/000000/open-book.png"/> Getting Started

To get started, you need to have a LaTeX distribution installed on your machine. If you don't have one, you can download and install [TeX Live](https://www.tug.org/texlive/) or [MikTeX](https://miktex.org/).

## Structure
## <img src="https://img.icons8.com/color/30/000000/open-book.png"/> Structure

The main file of the template is `main.tex`. This file includes the document class, packages, and configurations. It also includes the front page and the chapters of the presentation.

The `preamble` directory contains the preamble file which includes the necessary packages and configurations for the template.
- `main.tex`: The main file of the template, including document class, packages, configurations, front page, and chapters.
- `preamble`: Directory containing preamble file with necessary packages and configurations.
- `Figures`: Directory for images and graphics.
- `front_page.tex`: Code for the front page of the presentation.
- `chapters`: Directory for chapter files.

The `Figures` directory is where you can put your images and graphics. The path to this directory is already set in the `main.tex` file.
## <img src="https://img.icons8.com/color/30/000000/play.png"/> Usage

The `front_page` file contains the code for the front page of the presentation.
1. Fork and clone this repository to your local machine.
2. Edit `main.tex` and chapter files in the `chapters` directory.
3. Compile `main.tex` using your LaTeX distribution to generate a PDF presentation.

The `chapters` directory is where you can put your chapter files. You can include these files in the `main.tex` file.
## <img src="https://img.icons8.com/color/30/000000/circled-menu.png"/> Themes

## Usage
Choose between light and dark themes by uncommenting the corresponding line in `main.tex`:
- Light theme: `\usetheme[showmaxslides]{pureminimalistic}`
- Dark theme: `\usetheme[darkmode, showmaxslides]{pureminimalistic}`

To use this template, you can fork this repository and clone it to your local machine. Then, you can start editing the `main.tex` file and the chapter files in the `chapters` directory.
## <img src="https://img.icons8.com/color/30/000000/presentation.png"/> Front Page Configuration

You can compile the `main.tex` file using your LaTeX distribution. The output will be a PDF file of your presentation.
Modify the title, author, and date in `front_page.tex` to customize the front page of the presentation.

## Themes
## <img src="https://img.icons8.com/color/30/000000/stack-of-photos.png"/> Preamble

This template supports both light and dark themes. You can choose the theme by uncommenting the corresponding line in the `main.tex` file:
The `preamble` directory contains setup files and configurations for the LaTeX document. Modify `preamble.tex` to adjust overall settings.

For the light theme:
```latex
\usetheme[showmaxslides]{pureminimalistic}
```
## <img src="https://img.icons8.com/color/30/000000/download.png"/> Download The PDF

For the dark theme:
```latex
\usetheme[darkmode, showmaxslides]{pureminimalistic}
```
Download the `main.pdf` file, generated by the GitHub Actions workflow, from the "Actions" tab of your repository.

Sure, you can append the above information to the `README.md` file. Here's how you can do it:
## <img src="https://img.icons8.com/color/30/000000/code-fork.png"/> Contributing

## Front Page Configuration
Contribute to this project by forking the repository, making changes, and submitting a pull request.

The `front_page.tex` file is where the title page of the presentation is defined. This file contains the title, author, and date information that appears on the first page of the document.
## <img src="https://img.icons8.com/color/30/000000/copyright.png"/> License

To modify the author and course title, you need to locate the `\title` and `\author` commands in the `front_page.tex` file.

For example, to change the course title to "Advanced Data Engineering", you would modify the `\title` command as follows:

```latex
\title[Advanced Data Engineering] %optional
{Advanced Data Engineering}
```

To change the author to "Moustafa Mahmoud" and his role to "Senior Solution Architect", you would modify the `\author` command as follows:

```latex
\author[John Doe] {
John Doe \newline
\footnotesize \textcolor{ballblue}{\textbf{Data Scientist}} \newline
}
```

The text inside the square brackets `[]` is the short version of the title or author, which is used in places where the full title or author would not fit, such as in headers or footers. The text inside the curly braces `{}` is the full version of the title or author, which is used on the title page and in other places where there is enough space.

After making these changes, save the `front_page.tex` file and recompile your LaTeX document to see the changes on the title page.

## Preamble
The `preamble` directory contains various setup files and configurations for the LaTeX document. These files define the overall style, layout, and other settings of the document.

The main file in this directory is `preamble.tex`. This file includes all the necessary packages and configurations for the document. It sets up the document class, loads the necessary LaTeX packages, defines new commands, and sets layout parameters.

To modify the overall settings of the document, you can edit the `preamble.tex` file or add new setup files to the `preamble` directory and include them in the `preamble.tex` file.

## Download The PDF
The `main.pdf` file is generated as an artifact of the GitHub Actions workflow defined in the `build.yml` file. After the LaTeX document is compiled, the `main.pdf` file is uploaded as an artifact.

To find and download the `main.pdf` file, follow these steps:

1. Go to your GitHub repository where the workflow is running.
2. Click on the "Actions" tab.
3. Click on the workflow run you're interested in. This will usually be the most recent run, but you can also select a previous run.
4. In the workflow run summary page, scroll down to the "Artifacts" section.
5. Click on the `main.pdf` artifact to download it.

The downloaded file will be a ZIP archive containing the `main.pdf` file. You can extract this file to view the PDF document.

## Contributing
If you want to contribute to this project, feel free to fork this repository, make your changes, and submit a pull request.


## License

This project is licensed under the MIT License. See the `LICENSE` file for more details.
This project is licensed under the MIT License. See the `LICENSE` file for more details.
Binary file added readme_icons/21.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit b81dc86

Please sign in to comment.