mirror of
https://github.com/prurigro/hypothetical.git
synced 2024-11-22 07:54:11 -05:00
Include a bunch of information about the public-facing side of the site in the readme, and create empty folders for partial components
This commit is contained in:
parent
3c048f6096
commit
71e8146f9c
3 changed files with 30 additions and 1 deletions
31
readme.md
31
readme.md
|
@ -1,6 +1,6 @@
|
||||||
# Hypothetical Template
|
# Hypothetical Template
|
||||||
|
|
||||||
The Hypothetical website template
|
The Hypothetical website template based on Laravel 5.6
|
||||||
|
|
||||||
## Utilities
|
## Utilities
|
||||||
|
|
||||||
|
@ -23,6 +23,35 @@ or
|
||||||
{{ Language::select([ 'en' => "This is a sentence", 'fr' => "C'est une phrase" ]) }}
|
{{ Language::select([ 'en' => "This is a sentence", 'fr' => "C'est une phrase" ]) }}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Public
|
||||||
|
|
||||||
|
The default public facing website uses vue.js. To configure a non-SPA traditional website, look at the files in `traditional-bootstrap`.
|
||||||
|
|
||||||
|
The following list of files and directories are where various pieces of the public website are located:
|
||||||
|
|
||||||
|
* `resources/views/templates/base.blade.php`: The outer template for the entire website
|
||||||
|
* `resources/views/templates/public.blade.php`: The inner template for the public site
|
||||||
|
* `resources/assets/fonts`: The folder containing website fonts (these get loaded into `public/fonts/` by the gulpfile)
|
||||||
|
* `resources/assets/js/app.js`: The main javascript file that loads the public site
|
||||||
|
* `resources/assets/js/mixins`: The folder containing vue.js mixins that can be applied globally in `resources/assets/js/app.js` or in individual components
|
||||||
|
* `resources/assets/js/mixins/base-page.js`: The base-page mixin with page functionality that should be imported into all page components
|
||||||
|
* `resources/components`: The folder containing vue.js components
|
||||||
|
* `resources/components/pages`: Page components that should be imported into vue-router in `resources/assets/js/app.js`
|
||||||
|
* `resources/components/sections`: Section components (single-use per page) that should be imported into mixins or page components
|
||||||
|
* `resources/components/partials`: Partial components (multi-use per page or section) that should be imported into mixins and/or page and section components
|
||||||
|
* `resources/assets/sass/app.scss`: The main sass file for the public site
|
||||||
|
* `resources/assets/sass/_fonts.scss`: Stylesheet containing font declarations and mixins declared to use those fonts in other stylesheets
|
||||||
|
* `resources/assets/sass/_var.scss`: Stylesheet containing variables to be used in other stylesheets
|
||||||
|
* `resources/assets/sass/pages`: Stylesheets for page-specific styles wrapped in the respective page component class
|
||||||
|
* `resources/assets/sass/sections`: Stylesheets for section-specific styles wrapped in the respective section component class
|
||||||
|
* `resources/assets/sass/partials`: Stylessheets for partial-specific styles wrapped in the respective partial component class
|
||||||
|
* `resources/assets/sass/classes`: General stylesheets for classes that can be used anywhere
|
||||||
|
* `resources/assets/sass/mixins`: Stylesheets declaring SCSS mixins for use in other stylesheets
|
||||||
|
|
||||||
|
Dependencies can be included with bower or npm and loaded either into the `jsPublicLibs` array in the gulpfile or imported in the javascript.
|
||||||
|
|
||||||
|
Other information about database interaction, routing, controllers, etc can be viewed in the [Laravel Documentation](https://laravel.com/docs).
|
||||||
|
|
||||||
## Dashboard
|
## Dashboard
|
||||||
|
|
||||||
Unless otherwise stated all examples in this section are to be added to `app/Http/Controllers/DashboardController.php`.
|
Unless otherwise stated all examples in this section are to be added to `app/Http/Controllers/DashboardController.php`.
|
||||||
|
|
0
resources/assets/sass/partials/.gitkeep
Normal file
0
resources/assets/sass/partials/.gitkeep
Normal file
0
resources/components/partials/.gitkeep
Normal file
0
resources/components/partials/.gitkeep
Normal file
Loading…
Reference in a new issue