Skip to content

Commit

Permalink
docs: improve documentation (#14)
Browse files Browse the repository at this point in the history
  • Loading branch information
kantord authored Mar 28, 2022
1 parent 498323c commit fc01768
Show file tree
Hide file tree
Showing 2 changed files with 61 additions and 1 deletion.
59 changes: 59 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,65 @@
🌱 🎥 Markdown presentations using your webcam


## Usage


### Setup

In order to use Zoetic, you need to clone the Zoetic repository:

```bash
git clone [email protected]:kantord/zoetic.git
```

`cd` into the newly created folder

```bash
cd zoetic
```

Make sure to install dependencies before you try to run your slides:

```bash
yarn install
```

### Edit your slides

Place your slides inside `decks/`. See `decks/hello.mdx` for an example. You can use Markdown
in order to format your slides. In order to create multiple slides in one deck, you can use
`---` in order to separate the slides, for example:

```mdx
# First slide

---

Second slide
```

Want to use React components in your slides, or other more advanced features? Consult the
[mdx-deck documentation](https://github.com/jxnblk/mdx-deck).


### Test and present your slides

In order to run your slides, use `yarn zoetic`. For example, if your slides are in
`decks/hello.mdx`, then run

```bash
yarn zoetic hello.mdx
```

If you want to use `zoetic` in order to present on an online meeting, you have to use screen
sharing. Open `zoetic` before joining your call and make sure your camera is turned on and
zoetic has access to it. Then join your call without enabling your camera in the call.

Once you join your call, share just the zoetic window in the call. If you want to participate
in the call without the slides before starting your presentation, you can simple include an
empty slide.



## Planned features

Expand Down
3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"access": "public"
},
"bin": {
"zoetic": "./cli.js"
"zoetic": "./generate.js"
},
"repository": "[email protected]:kantord/zoetic.git",
"author": "Dániel Kántor <[email protected]>",
Expand All @@ -28,6 +28,7 @@
"scripts": {
"start": "./cli.js hello.mdx",
"build": "./cli.js build hello.mdx",
"zoetic": "./cli.js",
"help": "./cli.js",
"lint": "eslint .",
"format": "eslint . --fix"
Expand Down

0 comments on commit fc01768

Please sign in to comment.