246 lines
8.8 KiB
Markdown
Executable File
246 lines
8.8 KiB
Markdown
Executable File
# Specifics for CHILL website
|
||
|
||
## Using docker
|
||
|
||
**Note**: it is possible to install using this single command: `docker compose run --rm front npm i`
|
||
|
||
Since we are using docker to launch the website a few things must be done if you are launching it for the first time.
|
||
Follow these steps:
|
||
|
||
1. In docker-compose.yaml file replace `npm run dev` with `tail -f /dev/null`
|
||
(This allows the container to keep running while we install all the dependencies in package.json. Without this command the container would exit, because of error)
|
||
2. In another terminal window go into the container `docker-compose exec front sh`
|
||
3. Run `npm i`
|
||
4. Once all dependencies are installed exit the container and stop the container running in the other terminal window
|
||
5. Change the command line `tail -f /dev/null` back to `npm run dev`
|
||
6. In the package.json file change the dev command with `"hugo server --bind 0.0.0.0"`
|
||
7. Launch the container again `docker-compose up --force-recreate`
|
||
|
||
# Deployment
|
||
|
||
1. Create a changie to keep track of the changes you made and create a new version.
|
||
2. Launch the CI by tagging your last commits and pushing the tag. The tag should start with `v` and then the version number.
|
||
3. Change the tag in ansible and apply the changes
|
||
|
||
--------------------
|
||
|
||
<h1 align="center">Hugo + Tailwind CSS Starter and Boilerplate</h1>
|
||
|
||
<p align="center">Hugoplate is a free starter template built with Hugo, and TailwindCSS, providing everything you need to jumpstart your Hugo project and save valuable time.</p>
|
||
|
||
<p align="center">Made with ♥ by <a href="https://zeon.studio/"> Zeon Studio</a></p>
|
||
<p align=center> If you find this project useful, please give it a ⭐ to show your support.</p>
|
||
|
||
<h2 align="center"> <a target="_blank" href="https://hugoplate.netlify.app/" rel="nofollow">👀 Demo</a> | <a target="_blank" href="https://pagespeed.web.dev/analysis/https-hugoplate-netlify-app/6lyxjw6t4r?form_factor=desktop">Page Speed (95+)🚀</a>
|
||
</h2>
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/gohugoio/hugo/releases/tag/v0.118.2" alt="Contributors">
|
||
<img src="https://img.shields.io/static/v1?label=min-HUGO-version&message=0.118.2&color=f00&logo=hugo" />
|
||
</a>
|
||
|
||
<a href="https://github.com/zeon-studio/hugoplate/blob/main/LICENSE">
|
||
<img src="https://img.shields.io/github/license/zeon-studio/hugoplate" alt="license">
|
||
</a>
|
||
|
||
<a href="https://github.com/zeon-studio/hugoplate">
|
||
<img src="https://img.shields.io/github/languages/code-size/zeon-studio/hugoplate" alt="code size">
|
||
</a>
|
||
|
||
<a href="https://github.com/zeon-studio/hugoplate/graphs/contributors">
|
||
<img src="https://img.shields.io/github/contributors/zeon-studio/hugoplate" alt="contributors">
|
||
</a>
|
||
</p>
|
||
|
||
## 🎁 What's Included
|
||
|
||
We have included almost everything you need to start your Hugo project. Let's see what's included in this template:
|
||
|
||
### 📌 Key Features
|
||
|
||
- 👥 Multi-Authors
|
||
- 🎯 Similar Posts Suggestion
|
||
- 🔍 Search Functionality
|
||
- 🌑 Dark Mode
|
||
- 🏷️ Tags & Categories
|
||
- 🔗 Netlify setting pre-configured
|
||
- 📞 Support contact form
|
||
- 📱 Fully responsive
|
||
- 📝 Write and update content in Markdown
|
||
- 💬 Disqus Comment
|
||
- 🔳 Syntax Highlighting
|
||
|
||
### 📄 15+ Pre-designed Pages
|
||
|
||
- 🏠 Homepage
|
||
- 👤 About
|
||
- 📞 Contact
|
||
- 👥 Authors
|
||
- 👤 Author Single
|
||
- 📝 Blog
|
||
- 📝 Blog Single
|
||
- 🚫 Custom 404
|
||
- 💡 Elements
|
||
- 📄 Privacy Policy
|
||
- 🏷️ Tags
|
||
- 🏷️ Tag Single
|
||
- 🗂️ Categories
|
||
- 🗂️ Category Single
|
||
- 🔍 Search
|
||
|
||
### 📦 Tech Stack
|
||
|
||
- [Hugo](https://gohugo.io/)
|
||
- [Tailwind CSS](https://tailwindcss.com/)
|
||
- [PostCSS](https://postcss.org/)
|
||
- [PurgeCSS](https://purgecss.com/)
|
||
- [AutoPrefixer](https://autoprefixer.github.io/)
|
||
- [Hugo Modules](https://gohugo.io/hugo-modules/)
|
||
- [Markdown](https://markdownguide.org/)
|
||
- [Prettier](https://prettier.io/)
|
||
- [Jshint](https://jshint.com/)
|
||
- [Netlify](https://www.netlify.com/)
|
||
- [Vercel](https://vercel.com/)
|
||
- [Github Actions](https://github.com/features/actions)
|
||
- [Gitlab Ci](https://docs.gitlab.com/ee/ci/)
|
||
- [AWS Amplify](https://aws.amazon.com/amplify/)
|
||
|
||
---
|
||
|
||
## 🚀 Getting Started
|
||
|
||
First you need to [clone](https://github.com/zeon-studio/hugoplate) or [download](https://github.com/zeon-studio/hugoplate/archive/refs/heads/main.zip) the template repository, and then let's get started with the following process:
|
||
|
||
### ⚙️ Prerequisites
|
||
|
||
To start using this template, you need to have some prerequisites installed on your machine.
|
||
|
||
- [Hugo Extended v0.115+](https://gohugo.io/installation/)
|
||
- [Node v18+](https://nodejs.org/en/download/)
|
||
- [Go v1.20+](https://go.dev/doc/install)
|
||
|
||
### 👉 Project Setup
|
||
|
||
We build this custom script to make your project setup easier. It will create a new Hugo theme folder, and clone the Hugoplate theme into it. Then move the exampleSite folder into the root directory. So that you can start your Hugo server without going into the exampleSite folder. Use the following command to setup your project.
|
||
|
||
```bash
|
||
npm run project-setup
|
||
```
|
||
|
||
### 👉 Install Dependencies
|
||
|
||
Install all the dependencies using the following command.
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
### 👉 Development Command
|
||
|
||
Start the development server using the following command.
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
### 🎬 Still Confused? Watch a Quick Video
|
||
|
||
https://github.com/zeon-studio/hugoplate/assets/58769763/c260c0ae-91be-42ce-b8db-aa7f11f777bd
|
||
|
||
---
|
||
|
||
## 📝 Customization
|
||
|
||
This template has been designed with a lot of customization options in mind. You can customize almost anything you want, including:
|
||
|
||
### 👉 Site Config
|
||
|
||
You can change the site title, base URL, language, theme, plugins, and more from the `hugo.toml` file.
|
||
|
||
### 👉 Site Params
|
||
|
||
You can customize all the parameters from the `config/_default/params.toml` file. This includes the logo, favicon, search, SEO metadata, and more.
|
||
|
||
### 👉 Colors and Fonts
|
||
|
||
You can change the colors and fonts from the `data/theme.json` file. This includes the primary color, secondary color, font family, and font size.
|
||
|
||
### 👉 Social Links
|
||
|
||
You can change the social links from the `data/social.json` file. Add your social links here, and they will automatically be displayed on the site.
|
||
|
||
---
|
||
|
||
## 🛠 Advanced Usage
|
||
|
||
We have added some custom scripts to make your life easier. You can use these scripts to help you with your development.
|
||
|
||
### 👉 Update Modules
|
||
|
||
We have added a lot of modules to this template. You can update all the modules using the following command.
|
||
|
||
```bash
|
||
npm run update-modules
|
||
```
|
||
|
||
### 👉 Remove Dark Mode
|
||
|
||
If you want to remove dark mode from your project, then you have to do it manually from everywhere. So we build a custom script to do it for you. you can use the following command to remove dark mode from your project.
|
||
|
||
```bash
|
||
npm run remove-darkmode
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 Build And Deploy
|
||
|
||
After you finish your development, you can build or deploy your project almost everywhere. Let's see the process:
|
||
|
||
### 👉 Build Command
|
||
|
||
To build your project locally, you can use the following command. It will purge all the unused CSS and minify all the files.
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
### 👉 Deploy Site
|
||
|
||
We have provided 5 different deploy platform configurations with this template, so you can deploy easily.
|
||
|
||
- [Netlify](https://www.netlify.com/)
|
||
- [Vercel](https://vercel.com/)
|
||
- [Github Actions](https://github.com/features/actions)
|
||
- [Gitlab Ci](https://docs.gitlab.com/ee/ci/)
|
||
- [AWS Amplify](https://aws.amazon.com/amplify/)
|
||
|
||
And if you want to Host some other hosting platforms. then you can build your project, and you will get a `public` folder. that you can copy and paste on your hosting platform.
|
||
|
||
> **Note:** You must change the `baseURL` in the `hugo.toml` file. Otherwise, your site will not work properly.
|
||
|
||
---
|
||
|
||
## 🔒 Guide to Staying Compliant
|
||
|
||
### 🐞 Reporting Issues
|
||
|
||
We use GitHub Issues as the official bug tracker for this Template. Please Search [existing issues](https://github.com/zeon-studio/hugoplate/issues). It’s possible someone has already reported the same problem.
|
||
If your problem or idea has not been addressed yet, feel free to [open a new issue](https://github.com/zeon-studio/hugoplate/issues).
|
||
|
||
## 🖼️ Showcase
|
||
|
||
List of projects people are building with **Hugoplate**! Have you built a project with Hugoplate? Submit it by creating a pull request and we'll feature it here!
|
||
|
||
| [](https://open-neuromorphic.org/) | [](https://aimodels.org/) | [](https://www.hugobricks.preview.usecue.com/) |
|
||
|:---:|:---:|:---:|
|
||
| **Open Neuromorphic** | **AI Models** | **Hugobricks** |
|
||
|
||
### 📝 License
|
||
|
||
Copyright (c) 2023 - Present, Designed & Developed by [Zeon Studio](https://zeon.studio/)
|
||
|
||
**Code License:** Released under the [MIT](https://github.com/zeon-studio/hugoplate/blob/main/LICENSE) license.
|
||
|
||
**Image license:** The images are only for demonstration purposes. They have their license, we don't have permission to share those images.
|