📝 Creates showcase page

This commit is contained in:
Alicia Sykes
2021-06-26 16:44:25 +01:00
parent 369c6f10db
commit 382f86edf0
9 changed files with 109 additions and 24 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 MiB

View File

@@ -1,4 +1,4 @@
## Configuring
# Configuring
All app configuration is specified in [`/public/conf.yml`](https://github.com/Lissy93/dashy/blob/master/public/conf.yml) which is in [YAML Format](https://yaml.org/) format.
@@ -11,17 +11,17 @@ There's a couple of things to remember, before getting started:
- You can check that your config file fits the schema, by running `yarn validate-config`
- Any which are only saved locally through the UI need to be exported into this file, in order for them to persist across devices
#### Config Saving Methods
### Config Saving Methods
When updating the config through the JSON editor in the UI, you have two save options: **Local** or **Write to Disk**. Changes saved locally will only be applied to the current user through the browser, and to apply to other instances, you either need to use the cloud sync feature, or manually update the conf.yml file. On the other-hand, if you choose to write changes to disk, then your main `conf.yml` file will be updated, and changes will be applied to all users, and visible across all devices.
#### Preventing Changes being Written to Disk
### Preventing Changes being Written to Disk
To disallow any changes from being written to disk, then set `appConfig.allowConfigEdit: false`. If you are using users, and have setup `auth` within Dashy, then only users with `type: admin` will be able to write config changes to disk.
It is recommended to make a backup of your config file.
All fields are optional, unless otherwise stated.
#### Top-Level Fields
### Top-Level Fields
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -31,7 +31,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### `PageInfo`
### `PageInfo`
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -42,7 +42,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### `pageInfo.navLinks` _(optional)_
### `pageInfo.navLinks` _(optional)_
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -51,7 +51,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### `appConfig` _(optional)_
### `appConfig` _(optional)_
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -75,7 +75,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### `appConfig.auth` _(optional)_
### `appConfig.auth` _(optional)_
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -85,7 +85,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### `section`
### `section`
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -96,7 +96,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### `section.item`
### `section.item`
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -111,7 +111,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### `section.displayData` _(optional)_
### `section.displayData` _(optional)_
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -127,7 +127,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### `section.icon` and `section.item.icon`
### `section.icon` and `section.item.icon`
**Field** | **Type** | **Required**| **Description**
--- | --- | --- | ---
@@ -135,7 +135,7 @@ All fields are optional, unless otherwise stated.
**[⬆️ Back to Top](#configuring)**
#### Example
### Example
```yaml
---

63
docs/showcase.md Normal file
View File

@@ -0,0 +1,63 @@
# Dashy Showcase
> Do you use Dashy? Got a sweet dashboard? Submit it to the showcase! [See How](#submitting-your-dashboard)
### Home Lab 2.0
![screenshot-homelab](https://raw.githubusercontent.com/Lissy93/dashy/master/docs/showcase/1-home-lab-material.png)
---
### Networking Services
![screenshot-networking-services](https://raw.githubusercontent.com/Lissy93/dashy/master/docs/showcase/2-networking-services-minimal-dark.png)
---
### CFT Toolbox
![screenshot-cft-toolbox](https://raw.githubusercontent.com/Lissy93/dashy/master/docs/showcase/3-cft-toolbox.png)
---
### Bookmarks
![screenshot-bookmarks](https://raw.githubusercontent.com/Lissy93/dashy/master/docs/showcase/4-bookmarks-colourful.png)
---
### Project Management
![screenshot-project-managment](https://raw.githubusercontent.com/Lissy93/dashy/master/docs/showcase/5-project-managment.png)
---
## Submitting your Dashboard
#### How to Submit
- Open an Issue
- Open a PR
#### What to Include
Please include the following information:
- A single high-quality screenshot of your Dashboard
- A short title (it doesn't have to be particularly imaginative)
- An optional description, you could include details on anything interesting or unique about your dashboard, or say how you use it, and why it's awesome
- Optionally leave your name or username, with a link to your GitHub, Twitter or Website
#### Template
If you're submitting a pull request, please use a format similar to this:
```
### [Dashboard Name] (required)
> Submitted by [@username](https://github.com/user) (optional)
![dashboard-screenshot](/docs/showcase/screenshot-name.jpg) (required)
[An optional text description, or any interesting details] (optional)
---
```

Binary file not shown.

After

Width:  |  Height:  |  Size: 187 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 137 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 122 KiB