diff --git a/README.md b/README.md index 468f5ee..e146826 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,21 @@ -# Oblic Parallels Home Website +# Portulan ## About -Contains the source code of the Home OP website. -Now uses Astro instead of the old static website ! +Portulan is a project that lets you generate a website to showcase all of your services. It was originally created for homelabs but you may use it any way you can think of. +It's actually the source code for all the Oblic Parallels portals. ## How to use it +### Configuration + If you want to use this project for yourself, you'll first want to edit the configuration file located at `src/data/content.json`. The file should look like this, don't hesitate to take the provided template file to make yours. ```json { "website_title": "Website Title", "website_logo": "https://...", + "page_name": "", "website_status_link": "https://...", "colors": { ... // Optional @@ -40,7 +43,7 @@ The file should look like this, don't hesitate to take the provided template fil > "icon": "../assets/some-icon.svg", >``` -### Optimized image loading +#### Optimized image loading I would recommend to use only SVGs in your image links if possible. If it's not possible and that you want to optimize the loading time, you should use the lazy image loading. > [!WARNING] > This feature is not implemented yet and you'll have to go manually inside the `src/components/` folder to make modifications. @@ -74,6 +77,11 @@ const { title, icon, ... } = Astro.props; ``` Note that in this case, it would be a good idea to store your images in the assets folder an to access them using their relative path to let astro generate what it needs to fully take advantage of this feature. +### Automatic deployment + +There is a CI/CD pipeline in `.forgejo/workflows/deploy.yaml` that lets you automatically build and deploy the website. It's actually configured to do so with Oblic Parallels but you can easily use it to do the same thing on your own server. +As it takes time I don't really want to document it right now but if you're interested, feel free to contact me or to open an issue and I will probably do it. + ## Structure ### Project diff --git a/src/pages/index.astro b/src/pages/index.astro index a818721..8e79054 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -7,7 +7,7 @@ import "./index.css"; import Card from "../components/Card.astro"; import Logo from "../components/Logo.astro"; -import data from "../data/content.json"; +import data from "../data/test.json"; // === Defaults