-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
fdf7979
commit f6b778b
Showing
8 changed files
with
382 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Empty file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,51 @@ | ||
# Installation | ||
|
||
#info[ | ||
This installation process is temporary, as we wait for Typst to overhaul its | ||
process for packaging templates and packages. | ||
] | ||
|
||
The best way to install the Notebookinator is as a local package. Make sure you | ||
have the following software installed on your computer: | ||
|
||
- [Typst](https://github.com/casey/just#installation) | ||
- [Git](https://github.com/casey/just#installation) | ||
- [VSCode](https://code.visualstudio.com/) | ||
- [just](https://github.com/casey/just#installation) | ||
|
||
Once you've installed everything, simply run the following commands: | ||
|
||
```bash | ||
git clone https://github.com/BattleCh1cken/notebookinator | ||
cd notebookinator | ||
just install | ||
``` | ||
|
||
> If you're running this on Windows, you'll need to run these commands in a sh | ||
> shell, like git-bash or the shell packaged with Cygwin or GitHub Desktop. | ||
# Basic Usage | ||
|
||
Once the template is installed, you can import it into your project like this: | ||
|
||
```typ | ||
#import "@local/notebookinator:1.0.1": * | ||
``` | ||
|
||
Once you've done that you can begin to write your notebook: | ||
|
||
```typ | ||
#import themes.default: default-theme, components | ||
#show: notebook.with(theme: default-theme) | ||
#create-body-entry(title: "My Entry")[ | ||
#lorem(200) | ||
] | ||
``` | ||
|
||
You can then compile your notebook with the Typst CLI: | ||
|
||
```bash | ||
typst compile your-notebook-file.typ | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
# Introduction | ||
|
||
Welcome to the Notebookinator, a Typst package meant to simplify the notebooking | ||
process for the Vex Robotics Competition. Its theming capabilities handle all of | ||
the styling for you, letting you jump right into writing documentation. | ||
|
||
While it was designed with VRC in mind, it could just as easily be used for | ||
other competitor systems such as the First Robotics Competition and the First | ||
Tech Challenge. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,3 @@ | ||
# API Reference | ||
|
||
Check out the API reference [here](./reference.pdf). |
Oops, something went wrong.