Skip to content

Commit

Permalink
init hugo cms
Browse files Browse the repository at this point in the history
  • Loading branch information
tbsbdr committed Apr 14, 2024
1 parent 215dd44 commit 253d282
Show file tree
Hide file tree
Showing 426 changed files with 21,589 additions and 4,183 deletions.
117 changes: 1 addition & 116 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,118 +1,3 @@
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
lerna-debug.log*

# Diagnostic reports (https://nodejs.org/api/report.html)
report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json

# Runtime data
pids
*.pid
*.seed
*.pid.lock

# Directory for instrumented libs generated by jscoverage/JSCover
lib-cov

# Coverage directory used by tools like istanbul
coverage
*.lcov

# nyc test coverage
.nyc_output

# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
.grunt

# Bower dependency directory (https://bower.io/)
bower_components

# node-waf configuration
.lock-wscript

# Compiled binary addons (https://nodejs.org/api/addons.html)
build/Release

# Dependency directories
node_modules/
jspm_packages/

# TypeScript v1 declaration files
typings/

# TypeScript cache
*.tsbuildinfo

# Optional npm cache directory
.npm

# Optional eslint cache
.eslintcache

# Microbundle cache
.rpt2_cache/
.rts2_cache_cjs/
.rts2_cache_es/
.rts2_cache_umd/

# Optional REPL history
.node_repl_history

# Output of 'npm pack'
*.tgz

# Yarn Integrity file
.yarn-integrity

# dotenv environment variables file
.env
.env.test

# parcel-bundler cache (https://parceljs.org/)
.cache

# Next.js build output
.next

# Nuxt.js build / generate output
.nuxt

# Gatsby files
.cache/
# Comment in the public line in if your project uses Gatsby and *not* Next.js
# https://nextjs.org/blog/next-9-1#public-directory-support
# public

# vuepress build output
.vuepress/dist

# Serverless directories
.serverless/

# FuseBox cache
.fusebox/

# DynamoDB Local files
.dynamodb/

# TernJS port file
.tern-port
assets/fonts/.DS_Store
assets/fonts/.DS_Store
*.DS_Store
assets/.DS_Store
assets/fonts/.DS_Store
assets/.DS_Store
.DS_Store
assets/.DS_Store
assets/fonts/.DS_Store
**/.DS_Store

.DS_Store

assets/.DS_Store
assets/fonts/.DS_Store
/node_modules
Empty file added .hugo_build.lock
Empty file.
21 changes: 21 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
The MIT License (MIT)

Copyright (c) 2023 - Present, Zeon Studio

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
248 changes: 231 additions & 17 deletions README.md
100644 β†’ 100755
Original file line number Diff line number Diff line change
@@ -1,25 +1,239 @@
# Website for Electrictian Meister Baader
# Getting started
<h1 align="center">Hugo + Tailwind CSS Starter and Boilerplate</h1>

## 1. Install Tailwind CSS
Install tailwindcss via npm, and create your tailwind.config.js file.
<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>

```shell
npm install -D tailwindcss
````
```shell
npx tailwindcss init
<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.121.2" alt="Contributors">
<img src="https://img.shields.io/static/v1?label=min-HUGO-version&message=0.121.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/) by [Gethugothemes](https://gethugothemes.com/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
```

## 2. Start the Tailwind CLI build process
Run the CLI tool to scan your template files for classes and build your CSS.
### πŸ‘‰ Install Dependencies

```shell
npx tailwindcss -i ./src/input.css -o ./output.css --watch
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.

---
All details on:
https://tailwindcss.com/docs/installation

## References
https://www.istockphoto.com/de/foto/elektriker-arbeitet-an-elektro-panel-gm1165561132-320758763?phrase=electrician
## πŸ›  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 Theme

If you want to update the theme, then you can use the following command. It will update the theme to the latest version.

```bash
npm run update-theme
```

> **Note:** This command will work after running `project-setup` script.
### πŸ‘‰ 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, you can use the following command to remove dark mode from your project.

```bash
npm run remove-darkmode
```

> **Note:** This command will work before running `project-setup` script. If you already run the `project-setup` command, then you have to run `npm run theme-setup` first, and then you can run this command. afterward, you can run `npm run project-setup` again.
---

## πŸš€ 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).

### πŸ“ 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.

---

## πŸ–ΌοΈ Showcase

List of some projects people are building with **Hugoplate**!

| [![Open Neuromorphic](https://tinyurl.com/hp7avtje)](https://open-neuromorphic.org/) | [![AI Models](https://tinyurl.com/mu4p7dhb)](https://aimodels.org/) | [![Hugobricks](https://tinyurl.com/4x3uwhm9)](https://www.hugobricks.preview.usecue.com/) | [![ONO LLC](https://tinyurl.com/yxnu6whn)](https://ono.day/)
|:---:|:---:|:---:|:---:|
| **Open Neuromorphic** | **AI Models** | **Hugobricks** | **ONO LLC** |

---

## πŸ’» Need Customization?

If you need a custom theme, theme customization, or complete website development services from scratch you can [Hire Us](https://zeon.studio/estimate-project).
Loading

0 comments on commit 253d282

Please sign in to comment.