mirror of
https://github.com/BookStackApp/BookStack.git
synced 2024-08-26 12:16:07 +00:00
![Dan Brown](/assets/img/avatar_default.png)
- Primarily moved and re-organised view files. - Included readme within views to document the convention. - Fixed some issues with page field select list in previous commit. - Tweaked some route names while going through. - Split some views out further. Closes #2805
43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
# BookStack Views
|
|
|
|
All views within this folder are [Laravel blade](https://laravel.com/docs/6.x/blade) views.
|
|
|
|
### Overriding
|
|
|
|
Views can be overridden on a per-file basis via the visual theme system.
|
|
More information on this can be found within the `dev/docs/visual-theme-system.md`
|
|
file within this project.
|
|
|
|
### Convention
|
|
|
|
Views are broken down into rough domain areas. These aren't too strict although many of the folders
|
|
here will often match up to a HTTP controller.
|
|
|
|
Within each folder views will be structured like so:
|
|
|
|
```txt
|
|
- folder/
|
|
- page-a.blade.php
|
|
- page-b.blade.php
|
|
- parts/
|
|
- partial-a.blade.php
|
|
- partial-b.blade.php
|
|
- subdomain/
|
|
- subdomain-page-a.blade.php
|
|
- subdomain-page-b.blade.php
|
|
- parts/
|
|
- subdomain-partial-a.blade.php
|
|
- subdomain-partial-b.blade.php
|
|
```
|
|
|
|
If a folder contains no pages at all (For example: `attachments`, `form`) and only partials, then
|
|
the partials can be within the top-level folder instead of pages to prevent unneeded nesting.
|
|
|
|
If a partial depends on another partial within the same directory, the naming of the child partials should be an extension of the parent.
|
|
For example:
|
|
|
|
```txt
|
|
- tag-manager.blade.php
|
|
- tag-manager-list.blade.php
|
|
- tag-manager-input.blade.php
|
|
``` |