156 lines
3.1 KiB
Markdown
156 lines
3.1 KiB
Markdown
---
|
|
icon: lucide/rocket
|
|
---
|
|
# Welcome!
|
|
|
|
For full docs visit [zensical.org](https://zensical.org/docs/).
|
|
|
|
## Commands
|
|
|
|
- `zensical new` - Create a new project
|
|
- `zensical serve` - Start local web server
|
|
- `zensical build` - Build your site
|
|
|
|
## [[markdown]]
|
|
|
|
## Examples
|
|
|
|
### Admonitions
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/admonitions/)
|
|
|
|
!!! note
|
|
|
|
```text
|
|
This is a **note** admonition. Use it to provide helpful information.
|
|
```
|
|
|
|
!!! warning
|
|
|
|
```text
|
|
This is a **warning** admonition. Be careful!
|
|
```
|
|
|
|
### Details
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/admonitions/#collapsible-blocks)
|
|
|
|
??? info "Click to expand for more info"
|
|
|
|
```text
|
|
This content is hidden until you click to expand it.
|
|
Great for FAQs or long explanations.
|
|
```
|
|
|
|
## Code Blocks
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/code-blocks/)
|
|
|
|
```python
|
|
def greet(name):
|
|
print(f"Hello, {name}!") # (1)!
|
|
|
|
greet("Python")
|
|
```
|
|
|
|
1. Go to [documentation](https://zensical.org/docs/authoring/code-blocks/#code-annotations)
|
|
|
|
Code annotations allow to attach notes to lines of code.
|
|
|
|
Code can also be highlighted inline: `#!python print("Hello, Python!")`.
|
|
|
|
## Content tabs
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/content-tabs/)
|
|
|
|
=== "Python"
|
|
|
|
````text
|
|
``` python
|
|
print("Hello from Python!")
|
|
```
|
|
````
|
|
|
|
=== "Rust"
|
|
|
|
````text
|
|
``` rs
|
|
println!("Hello from Rust!");
|
|
```
|
|
````
|
|
|
|
## Diagrams
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/diagrams/)
|
|
|
|
``` mermaid
|
|
graph LR
|
|
A[Start] --> B{Error?};
|
|
B -->|Yes| C[Hmm...];
|
|
C --> D[Debug];
|
|
D --> B;
|
|
B ---->|No| E[Yay!];
|
|
```
|
|
|
|
## Footnotes
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/footnotes/)
|
|
|
|
Here's a sentence with a footnote.[1](#user-content-fn-1)
|
|
|
|
Hover it, to see a tooltip.
|
|
|
|
## Formatting
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/formatting/)
|
|
|
|
- ==This was marked (highlight)==
|
|
- ^^This was inserted (underline)^^
|
|
- ~~This was deleted (strikethrough)~~
|
|
- H~~2~~O
|
|
- A^T^A
|
|
- ++ctrl+alt+del++
|
|
|
|
## Icons, Emojis
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/icons-emojis/)
|
|
|
|
- :sparkles: `:sparkles:`
|
|
- :rocket: `:rocket:`
|
|
- :tada: `:tada:`
|
|
- :memo: `:memo:`
|
|
- :eyes: `:eyes:`
|
|
|
|
## Maths
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/math/)
|
|
|
|
$$
|
|
\cos x=\sum_{k=0}^{\infty}\frac{(-1)^k}{(2k)!}x^{2k}
|
|
$$
|
|
|
|
!!! warning "Needs configuration"\
|
|
Note that MathJax is included via a `script` tag on this page and is not\
|
|
configured in the generated default configuration to avoid including it\
|
|
in a pages that do not need it. See the documentation for details on how\
|
|
to configure it on all your pages if they are more Maths-heavy than these\
|
|
simple starter pages.
|
|
|
|
## Task Lists
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/lists/#using-task-lists)
|
|
|
|
- [x] Install Zensical
|
|
- [x] Configure `zensical.toml`
|
|
- [x] Write amazing documentation
|
|
- [ ] Deploy anywhere
|
|
|
|
## Tooltips
|
|
|
|
> Go to [documentation](https://zensical.org/docs/authoring/tooltips/)
|
|
|
|
[Hover me](https://example.com)
|
|
|
|
## Footnotes
|
|
|
|
1. This is the footnote. [↩](#user-content-fnref-1)
|