https://github.com/rochacbruno/blog

Create a blog hosted on github pages, powered by marmite SSG
https://github.com/rochacbruno/blog

blog blog-template marmite marmite-template rochacbruno-template ssg static-site static-site-generator

Last synced: 3 days ago
JSON representation

Create a blog hosted on github pages, powered by marmite SSG

• Host: GitHub
• URL: https://github.com/rochacbruno/blog
• Owner: rochacbruno
• Created: 2024-10-22T11:16:54.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-10-22T19:54:08.000Z (2 months ago)
• Last Synced: 2024-12-23T19:15:07.538Z (10 days ago)
• Topics: blog, blog-template, marmite, marmite-template, rochacbruno-template, ssg, static-site, static-site-generator
• Language: CSS
• Homepage:
• Size: 18.6 KB
• Stars: 6
• Watchers: 1
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Create your own blog now!

Your blog will be generated by [marmite](https://rochacbruno.github.io/marmite/)

 Click to see screenshots 

**Light Mode**

![index-light](https://github.com/user-attachments/assets/ebb177a3-5c28-437f-88d2-2400474dd84c)

![post-light](https://github.com/user-attachments/assets/c4ea0485-efee-438a-82d1-1c8d9b31a3e8)

**Dark Mode**

![index-dark](https://github.com/user-attachments/assets/c72a9216-e553-4d91-b48e-7b1e913b264f)

![post-dark](https://github.com/user-attachments/assets/61e6aad9-d84d-4e12-9737-ece02ffd39d2)

---

## Step 1

### As a Fork (recommended)

[CLICK ON FORK BUTTON](https://github.com/rochacbruno/blog/fork) and name your fork `blog`.

##### Or as a template

[Click on Use this template](https://github.com/new?template_name=blog&template_owner=rochacbruno&name=blog&description=Blog%20generated%20with%20Marmite) and name your new repo `blog`

## Step 2

Access https://github.com/YOURUSER/blog/actions and click the green button to enable actions.

## Step 3

Access https://github.com/YOURUSER/blog/settings/pages and set the

pages source to **Github Actions**

## Step 4

Then edit the `marmite.yaml` with your own information. (IMPORTANT! change the `url:..` field to match your own repo)

If you want to enable comments on the blog [read this](https://rochacbruno.github.io/marmite/enabling-comments.html)

## Step 5

Commit and see the Github Actions building a blog for you.

Your blog will be published at https://YOURUSER.github.io/blog

You can add add [custom domain](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site) later

You can customize `css` on `custom.css`, `JS` on `custom.js` and custom themes and other customization options are explained on [customization page](https://rochacbruno.github.io/marmite/tag/customization.html)

---

## Building locally

```console

$ git clone [email protected]:YOURUSER/blog.git

$ cd blog

```

```console

$ cargo install marmite

```

```console

$ marmite . site

Site generated at: /site/

```

Learn more on [marmite](https://rochacbruno.github.io/marmite/)