Drop Grav skeleton pages; hub is the site (#826)
This commit is contained in:
@@ -1,63 +0,0 @@
|
|||||||
---
|
|
||||||
title: Home
|
|
||||||
body_classes: title-center title-h1h2
|
|
||||||
---
|
|
||||||
|
|
||||||
# Say Hello to Grav 2.0!
|
|
||||||
## installation successful...
|
|
||||||
|
|
||||||
Congratulations! You have installed the **Base Grav 2.0 Package** that provides a **simple page** and the new default **Quark 2** theme to get you started — built on [Blades CSS](https://blades.ninja/) (the actively maintained successor to Pico CSS), Font Awesome 7, and a refined typographic system with light/dark/auto appearance.
|
|
||||||
|
|
||||||
> [!WARNING]
|
|
||||||
> If you see a **404 Error** when you click `Typography` in the menu, please refer to the [troubleshooting guide](http://learn.getgrav.org/troubleshooting/page-not-found).
|
|
||||||
|
|
||||||
### Find out all about Grav
|
|
||||||
|
|
||||||
* Learn about **Grav** by checking out our dedicated [Learn Grav](https://learn.getgrav.org) site.
|
|
||||||
* Download **plugins**, **themes**, and Grav **skeleton** packages from the [Grav Downloads](https://getgrav.org/downloads) page.
|
|
||||||
* Follow the [Grav Development Blog](https://getgrav.org/blog) to keep up with the latest happenings in the Grav-verse.
|
|
||||||
* Browse the source on [GitHub](https://github.com/getgrav/grav) and file issues or pull requests there.
|
|
||||||
|
|
||||||
> [!TIP]
|
|
||||||
> If you want a more **full-featured** base install, check out the [**Skeleton** packages available in the downloads](https://getgrav.org/downloads) — several have already been updated for Grav 2.0.
|
|
||||||
|
|
||||||
### Edit this Page
|
|
||||||
|
|
||||||
To edit this page, navigate to the folder you installed **Grav** into, and browse to the `user/pages/01.home` folder. Open `default.md` in your [editor of choice](https://learn.getgrav.org/basics/requirements). You'll see the content of this page written in [Markdown format](https://learn.getgrav.org/content/markdown).
|
|
||||||
|
|
||||||
### Create a New Page
|
|
||||||
|
|
||||||
Creating a new page is a simple affair in **Grav**. Follow these steps:
|
|
||||||
|
|
||||||
1. Navigate to your pages folder — `user/pages/` — and create a new folder. In this example, we'll use [explicit default ordering](https://learn.getgrav.org/content/content-pages) and call the folder `03.mypage`.
|
|
||||||
2. Launch your text editor and paste in the following sample content:
|
|
||||||
|
|
||||||
---
|
|
||||||
title: My New Page
|
|
||||||
---
|
|
||||||
# My New Page!
|
|
||||||
|
|
||||||
This is the body of **my new page** and I can easily use _Markdown_ syntax here.
|
|
||||||
|
|
||||||
3. Save this file in `user/pages/03.mypage/` as `default.md`. That tells **Grav** to render the page using the **default** template from Quark 2.
|
|
||||||
4. Reload your browser to see your new page appear in the menu.
|
|
||||||
|
|
||||||
> [!NOTE]
|
|
||||||
> The page will automatically show up in the menu after the **Typography** item. If you want a different label, add `menu: My Page` between the dashes in the front matter — this is the YAML header block, where all per-page options are configured.
|
|
||||||
|
|
||||||
### What's new in Grav 2.0
|
|
||||||
|
|
||||||
Grav 2.0 is the biggest release in the project's history — a modernized core, a rebuilt admin, a fresh default theme, and an updated dependency stack. Most of what you already know still works, but everything underneath has been sharpened.
|
|
||||||
|
|
||||||
* **PHP 8.3+** baseline, with a modernized core and typed internals throughout.
|
|
||||||
* **Symfony 7 + Twig 3** dependency stack, bringing the latest framework improvements and long-term support.
|
|
||||||
* **Quark 2** as the default theme — [Blades CSS](https://blades.ninja/), Font Awesome 7, auto/light/dark mode with `localStorage` persistence, locally-hosted Cal Sans + Inter fonts, and a refined Cal.com-inspired design system.
|
|
||||||
* **Admin 2.0** — a fully API-powered SPA interface that's dramatically faster, more responsive, and decoupled from page renders. Navigation, form saves, and media operations no longer trigger full reloads.
|
|
||||||
* **Public REST API** — the same endpoints that power Admin 2.0 are available to your own tools and integrations.
|
|
||||||
* **GitHub Markdown Alerts** — the legacy `markdown-notices` plugin has been replaced by `github-markdown-alerts`, using the familiar `> [!NOTE]` / `[!TIP]` / `[!IMPORTANT]` / `[!WARNING]` / `[!CAUTION]` syntax.
|
|
||||||
* **Refined caching and asset pipeline** — cleaner invalidation, faster cold starts, and smarter dependency fingerprinting.
|
|
||||||
* **Hardened security defaults** — tightened CSP headers, modern session handling, and improved input sanitization across core plugins.
|
|
||||||
* **Better developer ergonomics** — stricter type hints, cleaner event signatures, and clearer deprecation paths.
|
|
||||||
|
|
||||||
> [!IMPORTANT]
|
|
||||||
> Upgrading from Grav 1.x requires a migration. Follow the step-by-step guide at [getgrav.org/migrate-to-2](https://getgrav.org/migrate-to-2) — it covers pre-flight checks, the migration itself, and what to verify afterward.
|
|
||||||
@@ -1,176 +0,0 @@
|
|||||||
---
|
|
||||||
title: Typography
|
|
||||||
---
|
|
||||||
|
|
||||||
> [!NOTE]
|
|
||||||
> Quark 2 is Grav 2.0's default theme. It uses [Blades CSS](https://blades.ninja/) (the actively maintained successor to Pico CSS) as a classless foundation, layered with a Cal.com-inspired design system. Full Blades capabilities are documented in the [Official Blades CSS Docs](https://blades.ninja/#docs).
|
|
||||||
|
|
||||||
The [Quark 2 theme](https://github.com/getgrav/grav-theme-quark2) is Grav's new default, replacing the long-serving Quark (1.x) theme. It pairs a pure-grayscale palette with **Cal Sans** for display and **Inter** for body text (both hosted locally), Font Awesome 7 icons, and auto/light/dark appearance that persists in the user's browser. The layout system is CSS Grid + modern custom properties rather than a framework grid.
|
|
||||||
|
|
||||||
### Headings
|
|
||||||
|
|
||||||
Quark 2 uses **Cal Sans** for display headings and treats `h1` / `h2` distinctly — `h1` sits at a lighter display weight while `h2` is bolder and gains a small accent bar to mark section breaks. `h6` is rendered as an uppercase eyebrow label.
|
|
||||||
|
|
||||||
# H1 Heading — airy, display weight
|
|
||||||
|
|
||||||
## H2 Heading — confident, with accent bar
|
|
||||||
|
|
||||||
### H3 Heading — workhorse section heading
|
|
||||||
|
|
||||||
#### H4 Heading
|
|
||||||
|
|
||||||
##### H5 Heading
|
|
||||||
|
|
||||||
###### H6 Heading — uppercase eyebrow
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
# H1 Heading
|
|
||||||
## H2 Heading
|
|
||||||
### H3 Heading
|
|
||||||
#### H4 Heading
|
|
||||||
##### H5 Heading
|
|
||||||
###### H6 Heading
|
|
||||||
```
|
|
||||||
|
|
||||||
### Paragraphs
|
|
||||||
|
|
||||||
Body copy is set in **Inter** at 16px with a 1.7 line-height and subtle tracking. Links adopt the theme's **accent color** — by default a restrained charcoal, but configurable to any hex via `Themes → Quark 2 → Accent Color`.
|
|
||||||
|
|
||||||
Lorem ipsum dolor sit amet, consectetur [adipiscing elit. Praesent risus leo, dictum in vehicula sit amet](#), feugiat tempus tellus. Duis quis sodales risus. Etiam euismod ornare consequat.
|
|
||||||
|
|
||||||
Climb leg rub face on everything give attitude nap all day for under the bed. Chase mice attack feet but rub face on everything hopped up on goofballs.
|
|
||||||
|
|
||||||
### Markdown Semantic Text Elements
|
|
||||||
|
|
||||||
**Bold** `**Bold**`
|
|
||||||
|
|
||||||
_Italic_ `_Italic_`
|
|
||||||
|
|
||||||
~~Deleted~~ `~~Deleted~~`
|
|
||||||
|
|
||||||
`Inline Code` `` `Inline Code` ``
|
|
||||||
|
|
||||||
### HTML Semantic Text Elements
|
|
||||||
|
|
||||||
<abbr>I18N</abbr> `<abbr>`
|
|
||||||
|
|
||||||
<cite>Citation</cite> `<cite>`
|
|
||||||
|
|
||||||
<kbd>Ctrl + S</kbd> `<kbd>`
|
|
||||||
|
|
||||||
Text<sup>Superscripted</sup> `<sup>`
|
|
||||||
|
|
||||||
Text<sub>Subscripted</sub> `<sub>`
|
|
||||||
|
|
||||||
<u>Underlined</u> `<u>`
|
|
||||||
|
|
||||||
<mark>Highlighted</mark> `<mark>`
|
|
||||||
|
|
||||||
<time>20:14</time> `<time>`
|
|
||||||
|
|
||||||
<var>x = y + 2</var> `<var>`
|
|
||||||
|
|
||||||
### Blockquote
|
|
||||||
|
|
||||||
> The advance of technology is based on making it fit in so that you don't really even notice it,
|
|
||||||
> so it's part of everyday life.
|
|
||||||
>
|
|
||||||
> <cite>- Bill Gates</cite>
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
> The advance of technology is based on making it fit in so that you don't really even notice it,
|
|
||||||
> so it's part of everyday life.
|
|
||||||
>
|
|
||||||
> <cite>- Bill Gates</cite>
|
|
||||||
```
|
|
||||||
|
|
||||||
### Unordered List
|
|
||||||
|
|
||||||
* list item 1
|
|
||||||
* list item 2
|
|
||||||
* list item 2.1
|
|
||||||
* list item 2.2
|
|
||||||
* list item 2.3
|
|
||||||
* list item 3
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
* list item 1
|
|
||||||
* list item 2
|
|
||||||
* list item 2.1
|
|
||||||
* list item 2.2
|
|
||||||
* list item 2.3
|
|
||||||
* list item 3
|
|
||||||
```
|
|
||||||
|
|
||||||
### Ordered List
|
|
||||||
|
|
||||||
1. list item 1
|
|
||||||
1. list item 2
|
|
||||||
1. list item 2.1
|
|
||||||
1. list item 2.2
|
|
||||||
1. list item 2.3
|
|
||||||
1. list item 3
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
1. list item 1
|
|
||||||
1. list item 2
|
|
||||||
1. list item 2.1
|
|
||||||
1. list item 2.2
|
|
||||||
1. list item 2.3
|
|
||||||
1. list item 3
|
|
||||||
```
|
|
||||||
|
|
||||||
### Table
|
|
||||||
|
|
||||||
| Name | Genre | Release date |
|
|
||||||
| :-------------------------- | :---------------------------: | -------------------: |
|
|
||||||
| The Shawshank Redemption | Crime, Drama | 14 October 1994 |
|
|
||||||
| The Godfather | Crime, Drama | 24 March 1972 |
|
|
||||||
| Schindler's List | Biography, Drama, History | 4 February 1994 |
|
|
||||||
| Se7en | Crime, Drama, Mystery | 22 September 1995 |
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
| Name | Genre | Release date |
|
|
||||||
| :-------------------------- | :---------------------------: | -------------------: |
|
|
||||||
| The Shawshank Redemption | Crime, Drama | 14 October 1994 |
|
|
||||||
| The Godfather | Crime, Drama | 24 March 1972 |
|
|
||||||
| Schindler's List | Biography, Drama, History | 4 February 1994 |
|
|
||||||
| Se7en | Crime, Drama, Mystery | 22 September 1995 |
|
|
||||||
```
|
|
||||||
|
|
||||||
### Alerts
|
|
||||||
|
|
||||||
Grav 2.0 replaces the legacy `markdown-notices` plugin with [`github-markdown-alerts`](https://github.com/grav/grav-plugin-github-markdown-alerts), which renders [GitHub-flavored Markdown alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts). Five types are available, each with an accent stripe, icon, and label:
|
|
||||||
|
|
||||||
> [!NOTE]
|
|
||||||
> Highlights information that users should take into account, even when skimming.
|
|
||||||
|
|
||||||
> [!TIP]
|
|
||||||
> Optional information to help a user be more successful.
|
|
||||||
|
|
||||||
> [!IMPORTANT]
|
|
||||||
> Crucial information necessary for users to succeed.
|
|
||||||
|
|
||||||
> [!WARNING]
|
|
||||||
> Critical content demanding immediate user attention due to potential risks.
|
|
||||||
|
|
||||||
> [!CAUTION]
|
|
||||||
> Negative potential consequences of an action.
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
> [!NOTE]
|
|
||||||
> Highlights information that users should take into account, even when skimming.
|
|
||||||
|
|
||||||
> [!TIP]
|
|
||||||
> Optional information to help a user be more successful.
|
|
||||||
|
|
||||||
> [!IMPORTANT]
|
|
||||||
> Crucial information necessary for users to succeed.
|
|
||||||
|
|
||||||
> [!WARNING]
|
|
||||||
> Critical content demanding immediate user attention due to potential risks.
|
|
||||||
|
|
||||||
> [!CAUTION]
|
|
||||||
> Negative potential consequences of an action.
|
|
||||||
```
|
|
||||||
|
|
||||||
Reference in New Issue
Block a user