# Pages

Create the rules website, write pages with blocks, organize the menu into groups and publish the changes when everything looks right.

Source: https://fivedash.fivex.gg/docs/en/rules/pages

**Rules → Pages** is where the city's rules editor lives. Each page is a topic (welcome, general rules, penalties, police, factions), and groups organize the pages in the website's menu. Everything you write is a draft and only reaches the website when you click **Publish**. This page is for whoever writes and organizes the rules.

[Video: how to do it in under 20 seconds](https://fivedash.fivex.gg/docs/videos/rules-pages-en.mp4)

## Before you start

* **Plan:** the Rules module in the organization's plan.
* **Access level:**

| What to do                                              | Level needed               |
| ------------------------------------------------------- | -------------------------- |
| Read the pages and drafts                               | **Pages** at **View**      |
| Create the website, write, organize, delete and publish | **Pages** at **Configure** |

## Create the rules website

The first time someone opens **Rules → Pages**, **Create the rules website** shows up, with three steps.

### Address and name

In **Free address**, choose the website's address (it lives at `https://<address>.fivedash.site`). In **Website name**, write what the website is called (default: "Rules"). Click **Continue**.

### Where to start

Pick **Ready-made template** (recommended), **Blank** or, if the website already has drafts, **Keep the current pages**. Click **Continue**.

### Appearance

Pick **Same as the store** (the server's store colors, fonts and brand) or **Website only** (its own colors). With **Website only**, pick the **Accent** color. Click **Create rules website**.

### Open the editor

At the end, click **Open the editor**. The website is created but **Offline**: only the team sees it.

### First step options

| Field            | What it does                                                                              | Rules                                                                                                                                 |
| ---------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Free address** | The website's address on `fivedash.site`. You can change it later in **Rules → Website**. | 3 to 32 characters, lowercase letters, numbers and hyphens. Can't belong to another city or be reserved (like `admin`, `api`, `www`). |
| **Website name** | Shows next to the city's brand, at the top and in the browser tab.                        | Up to 60 characters.                                                                                                                  |

### Templates

| Option                     | What it creates                                                                                                                                                                                    |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ready-made template**    | Three pages with the most common RP rules, to adapt: **Welcome** (group "Getting started"), **General rules** and **Punishments** (group "Rules"). The template is written in the city's language. |
| **Blank**                  | An empty page to write your way.                                                                                                                                                                   |
| **Keep the current pages** | The drafts the website already has, as they are.                                                                                                                                                   |

> Switching to **Ready-made template** or **Blank** removes the current pages from the drafts. What's already published stays on the website until the next publish.

## The editor

| Part                 | Where                    | What it does                                                                               |
| -------------------- | ------------------------ | ------------------------------------------------------------------------------------------ |
| **Navigation**       | On the left              | The list of pages by group. The **+** (**Add**) creates a **New page** or a **New group**. |
| Open page            | In the middle            | Icon, cover, title, summary, address and the content.                                      |
| **Publish**          | At the top               | Shows the changes and publishes the website.                                               |
| **Website settings** | Below the navigation     | Takes you to **Rules → Website**. The green dot means **Live**.                            |
| **Assistant**        | At the top of the editor | The **Rules assistant**.                                                                   |

## Create and write a page

### Create the page

In **Navigation**, click **+** and then **New page**. To create it inside a group, open the group's menu (**…**) and click **New page here**.

### Add a title and summary

Write the **Page title** and, below it, the one-line summary ("A one-line summary, shown under the title").

### Write the content

Type the text. Type `/` to pick a block (headings, callouts, tables, steps, videos).

### Check it saved

The page saves itself as you type: you see **Saving…** and then **Saved**.

### Page fields

| Field            | What it does                                                                                                                                                      | Default                                                              |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| Icon             | An emoji next to the title and in the menu (**Add icon**). **Show only in the menu** removes the icon from the top of the page.                                   | No icon                                                              |
| Cover            | An image at the top of the page (**Add cover**), with cropping. The cover also becomes the image for that page's link.                                            | No cover                                                             |
| **Page title**   | The title at the top and in the menu. Up to 80 characters.                                                                                                        | **New page**                                                         |
| Summary          | One line under the title. Up to 200 characters.                                                                                                                   | Empty                                                                |
| **Page address** | The end of the page's link: `https://<address>.fivedash.site/<page-address>`. Up to 60 characters, lowercase letters, numbers and hyphens, unique on the website. | **Automatic**: follows the title while the page isn't on the website |

**Page address** also has **Generate from title**, **Copy link** and **Open the preview**.

> Changing the address of a page that's already on the website breaks the old link at the next publish: the old address stops working and links already shared on Discord break.

## Blocks

Type `/` on an empty line to open the blocks.

| Section   | Block                                                                | What it's for                                                                                                 |
| --------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Text      | **Text**                                                             | A plain paragraph.                                                                                            |
| Text      | **Heading**                                                          | Opens a topic on the page (shows in "On this page" on the website).                                           |
| Text      | **Subheading**                                                       | Splits a topic.                                                                                               |
| Text      | **Quote**                                                            | A highlighted excerpt.                                                                                        |
| Text      | **Code**                                                             | Commands and config snippets.                                                                                 |
| Lists     | **List**                                                             | Bulleted items.                                                                                               |
| Lists     | **Numbered list**                                                    | Items in order: 1, 2, 3.                                                                                      |
| Lists     | **Steps**                                                            | A numbered step-by-step, with titles.                                                                         |
| Callouts  | **Note**, **Info**, **Tip**, **Warning**, **Forbidden**, **Allowed** | A colored box. **Forbidden** is for what isn't allowed, and the penalty.                                      |
| Structure | **Divider**                                                          | A line between sections.                                                                                      |
| Structure | **Accordion**                                                        | A title that opens and closes the text.                                                                       |
| Structure | **Cards**                                                            | Shortcuts to other pages (`/another-page`) or links.                                                          |
| Structure | **Table**                                                            | Rows and columns, like fines and penalties.                                                                   |
| Structure | **Update**                                                           | A date (or version) and what changed in the rules.                                                            |
| Media     | **Image**                                                            | PNG, JPG or WebP up to 1 MB.                                                                                  |
| Media     | **Video**                                                            | YouTube, Vimeo, Twitch, Streamable or an .mp4 / .webm file. Only plays on the website when someone clicks it. |
| Media     | **Audio**                                                            | Spotify, SoundCloud or an .mp3 / .ogg / .wav file.                                                            |

### Formatting shortcuts

| Format            | Shortcut                           |
| ----------------- | ---------------------------------- |
| **Bold**          | Ctrl+B                             |
| **Italic**        | Ctrl+I                             |
| **Strikethrough** | Ctrl+Shift+S                       |
| **Code**          | Ctrl+E                             |
| **Link**          | Ctrl+K (paste the link or `/page`) |

## Organize the menu

* **Move a page:** drag the page by the handle to the left of its name. Drop it under another group's name to move the page to that group.
* **Create a group:** **+** → **New group**. Enter the **Group name** (up to 40 characters, like "Factions", "Police", "Business") and click **Create group**. The new group starts with one page.
* **Rename a group:** the group's menu (**…**) → **Rename group** → **Save**.

## Delete a page

### Open the page's menu

In **Navigation**, hover the page and click **…** (**Options for …**).

### Delete it

Click **Delete page** and confirm with **Delete page**.

The draft goes away right away. On the website, the page stays until the next publish. The website needs at least one page.

## Publish

Pages with changes get a yellow dot in **Navigation**: **New**, **Edited**, **Moved** or **Removed**, "not published".

### Open the publish menu

At the top, click **Publish**. The menu shows how many changes are waiting and the version the website shows now ("The website shows the version from …, published by …").

### Publish

Click **Publish changes** (or **Publish the website**, the first time). **Rules published** shows up.

### Put it live, if it isn't yet

If you see "The website is still offline.", turn on **Live** in **Rules → Website** and save.

> Publishing also updates the rules panel on Discord (shortcuts and last update date).

## Limits

| Item              | Limit                   |
| ----------------- | ----------------------- |
| Pages per website | 60                      |
| Page title        | 80 characters           |
| Page summary      | 200 characters          |
| Group name        | 40 characters           |
| Page address      | 60 characters           |
| Image in a block  | 1 MB (PNG, JPG or WebP) |

## Rules assistant

At the top of the editor, **Assistant** opens the **Rules assistant** ("How can I help with the rules?"). With **Pages** at **Configure**, it writes, reviews, creates, moves and deletes pages, and everything stays a draft until you publish. With **View**, it only reads, explains and suggests. Deleting a page and publishing the website ask for your confirmation. Ready-made ideas include **Create the penalties page**, **Organize the menu**, **What's missing from the rules?** and **Suggest a penalties table**. It needs FiveDash AI in the plan.

## FAQ

**I saved and the website didn't change. Why?**
Saving only keeps the draft. Click **Publish** at the top to send it to the website.

**I got "Fix the page with an error before publishing."**
A page has a problem, like an empty title or a repeated address. Open the flagged page and fix it.

**Can I see how it looks before publishing?**
Yes. In **Page address**, click **Open the preview**: the team sees the drafts on the website, with the "Team preview" notice.

## Next steps

[Website](https://fivedash.fivex.gg/docs/en/rules/site)Address, name and going live.
[Discord panel](https://fivedash.fivex.gg/docs/en/rules/discord-panel)Bring the pages to Discord.
[Rules overview](https://fivedash.fivex.gg/docs/en/rules/overview)How the module works.
[Panel assistant](https://fivedash.fivex.gg/docs/en/dashboard/assistant)How FiveDash assistants work.
