add documentation

This commit is contained in:
Ruidy 2023-06-04 09:10:21 +02:00
parent f41c8a1f54
commit 43f5982d5d
3 changed files with 47 additions and 12 deletions

View file

@ -2,6 +2,51 @@
[![Netlify Status](https://api.netlify.com/api/v1/badges/aa5c29ee-eced-46dd-ad53-1e0822001364/deploy-status)](https://app.netlify.com/sites/villafleurie-site/deploys) [![Netlify Status](https://api.netlify.com/api/v1/badges/aa5c29ee-eced-46dd-ad53-1e0822001364/deploy-status)](https://app.netlify.com/sites/villafleurie-site/deploys)
## Static Site Generator
The entry point is located in the [main file](./lib/main.py). It should not be modified.
The templates files must be located in the [templates](./templates) directory.
You can use template inheritance but not yet data injection.
### Configuration
The configuration file ([config.json](./config.json)) is mandatory and should resemble:
```json
{
"name": "VillaFleurie",
"templates": [
"index.html",
"t2-corail.html",
"t3-azur.html",
"contact.html",
"reservation.html"
],
"outDir": "dist"
}
```
### Site Generation
You can generate the site by running:
```shell
python -m lib.main
```
### How to run the website
It will generate the final files in the [dist](./dist) folder.
You can run the output files using a simple python server:
```shell
cd dist && python -m http.server
```
### Deployment
You can then deploy the site on any platform supporting static sites (Netlify,…) or your own VPS.
## TODO ## TODO
- [X] Create a base template for the header and footer - [X] Create a base template for the header and footer

7
dist/index.html vendored
View file

@ -476,11 +476,6 @@
</div> </div>
</div> </div>
<!-- end of card --> <!-- end of card -->
<!-- Card -->
<!-- end of card -->
</div> <!-- end of col --> </div> <!-- end of col -->
</div> <!-- end of row --> </div> <!-- end of row -->
</div> <!-- end of container --> </div> <!-- end of container -->
@ -704,7 +699,7 @@
<li><i class="fas fa-map-marker-alt"></i>VillaFleurie, 4 rue Gerty Archimède, 97190 Le Gosier, <li><i class="fas fa-map-marker-alt"></i>VillaFleurie, 4 rue Gerty Archimède, 97190 Le Gosier,
Guadeloupe Guadeloupe
</li> </li>
<li><i class="fas fa-phone"></i><a class="green" href="tel:003024630820">+590 690 44 15 30</a></li> <li><i class="fas fa-phone"></i><a class="green" href="tel:+33658961279">+33 6 58 96 12 79</a></li>
<li><i class="fas fa-envelope"></i><a class="green" href="mailto:reception@villa.com">location.villafleurie@gmail.com</a> <li><i class="fas fa-envelope"></i><a class="green" href="mailto:reception@villa.com">location.villafleurie@gmail.com</a>
</li> </li>
</ul> </ul>

View file

@ -401,11 +401,6 @@
</div> </div>
</div> </div>
<!-- end of card --> <!-- end of card -->
<!-- Card -->
<!-- end of card -->
</div> <!-- end of col --> </div> <!-- end of col -->
</div> <!-- end of row --> </div> <!-- end of row -->
</div> <!-- end of container --> </div> <!-- end of container -->
@ -629,7 +624,7 @@
<li><i class="fas fa-map-marker-alt"></i>VillaFleurie, 4 rue Gerty Archimède, 97190 Le Gosier, <li><i class="fas fa-map-marker-alt"></i>VillaFleurie, 4 rue Gerty Archimède, 97190 Le Gosier,
Guadeloupe Guadeloupe
</li> </li>
<li><i class="fas fa-phone"></i><a class="green" href="tel:003024630820">+590 690 44 15 30</a></li> <li><i class="fas fa-phone"></i><a class="green" href="tel:+33658961279">+33 6 58 96 12 79</a></li>
<li><i class="fas fa-envelope"></i><a class="green" href="mailto:reception@villa.com">location.villafleurie@gmail.com</a> <li><i class="fas fa-envelope"></i><a class="green" href="mailto:reception@villa.com">location.villafleurie@gmail.com</a>
</li> </li>
</ul> </ul>