Update making-your-own-blog.md

main
Crimson Tome 2021-10-16 18:49:24 +01:00 committed by GitHub
parent 8be4ac3e22
commit 8de3054e89
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 12 deletions

View File

@ -24,24 +24,24 @@ First of all, if you want to use GitHub as the source for your code you'll need
You can either create your own from scratch and setup a framework later
- Go to <https://github.com/new>
- Under ``Repository name`` enter what you want the repo to be called e.g. my-blog
- Under ``Description `` you can add a bit about your site, for example what it is about and how it is made
- Make sure ``Public`` is ticked, it should be by default
- You can tick ``Add a README file `` to go into more detail about your code if you wish. It is not completely necessary but may be useful for explaining your repo to other users or those that are interested but don't understand what exactly is going on by viewing the code itself
- Click ``Create repository``
- Under `Repository name` enter what you want the repo to be called e.g. my-blog
- Under `Description` you can add a bit about your site, for example what it is about and how it is made
- Make sure `Public` is ticked, it should be by default
- You can tick `Add a README file` to go into more detail about your code if you wish. It is not completely necessary but may be useful for explaining your repo to other users or those that are interested but don't understand what exactly is going on by viewing the code itself
- Click `Create repository`
**OR**
You can create your repo using a template (what I did) e.g Eleventy's base template
- Go to <https://github.com/11ty/eleventy-base-blog/generate>
- Under ``Repository name`` enter what you want the repo to be called e.g. my-blog
- Under ``Description `` you can add a bit about your site, for example what it is about and how it is made
- Make sure ``Public`` is ticked, it should be by default
- Keep ``Include all branches`` unticked (it's what I did, so some things may be different if you decide to tick it, I can't help with some things at that point)
- Under `Repository name` enter what you want the repo to be called e.g. my-blog
- Under `Description` you can add a bit about your site, for example what it is about and how it is made
- Make sure `Public` is ticked, it should be by default
- Keep `Include all branches` unticked (it's what I did, so some things may be different if you decide to tick it, I can't help with some things at that point)
GitHub will then generate your repo using the eleventy base blog template. There will be a list of files generated, an important one being ``README.md``. As the README states, you will need to ``Edit _data/metadata.json``. You will find this at ``https://github.com/your-github-name/your-repo-name/blob/master/_data/metadata.json``. But first, make sure you commit your changes if you've made any and let's head over to [Netlify](https://app.netlify.com/signup).
You can use your email or GitHub login (I'd recommend using GH as that is what I did). Once logged in go to <https://app.netlify.com/start>, choose ``GitHub`` as the option for Continuous Deployment then select your repo you have created with the elventy template. Then click ``Deploy site``. Head to ``https://app.netlify.com/sites/user-name/settings/general#site-details``. For now Netlify provides you with its own subdomain at ``subdomain.netlify.app`` but you can change it by presssing ``Change site name``.
GitHub will then generate your repo using the eleventy base blog template. There will be a list of files generated, an important one being `README.md`. As the README states, you will need to `Edit _data/metadata.json`. You will find this at `https://github.com/your-github-name/your-repo-name/blob/master/_data/metadata.json`. But first, make sure you commit your changes if you've made any and let's head over to [Netlify](https://app.netlify.com/signup).
You can use your email or GitHub login (I'd recommend using GH as that is what I did). Once logged in go to <https://app.netlify.com/start>, choose `GitHub` as the option for Continuous Deployment then select your repo you have created with the elventy template. Then click `Deploy site`. Head to `https://app.netlify.com/sites/user-name/settings/general#site-details`. For now Netlify provides you with its own subdomain at `subdomain.netlify.app` but you can change it by presssing `Change site name`.
Back to GitHub, remember `metadata.json`? You'll need to fill that in now to customise the template to match you.
```
{
@ -68,9 +68,11 @@ Back to GitHub, remember `metadata.json`? You'll need to fill that in now to cus
```
Make sure to commit your changes and then netlify should automatically rebuild your site. It shouldn't take more than a minute to do so.
You can add an about me page by editing ``/about/index.md``. Leave the stuff surrounded by.
You can add an about me page by editing `/about/index.md`. Leave the stuff surrounded by.
```
'```
```'
```
Now then, you'll probably want to make some blog posts, this is a blog repo that you're maiing after all right?
The Eleventy base blog template comes with a few in `/posts`