Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Broken image links #15

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Broken image links #15

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4752702
fix relative image links on getting started post
Sep 9, 2020
e0896cd
one too many slashes
Sep 9, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions src/posts/2020-03-20-getting-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@ date: 2020-03-20T18:00
To publish a website with this template, there are two options, depending on your technical skillset. Choose which one describes you best:

* [I'm not a developer](#no-code-setup), I just want to set up a website
* [I have basic knowledge](#advanced-setup) of how to use `npm` and the command line
* [I have basic knowledge](#advanced-setup) of how to use `npm` and the command line

## No-Code Setup

You don't need any programming skills to set up a site with this template.
You don't need any programming skills to set up a site with this template.
Following these steps, you can get started without touching any code:

1. [Get a GitHub account](#get-a-github-account) (skip if you have one)
Expand Down Expand Up @@ -38,15 +38,15 @@ Once these two accounts are set up, go ahead an click the following button to de

It will open a window with instructions:

![connect to Github](/static/images/uploads/netlify-deploy-step1.png)
![connect to Github](/src/static/images/uploads/netlify-deploy-step1.png)

Click the button "Connect to Github". (You should already be logged in, but if you're not, log in).

### Configure your site

Next, you need to provide a few settings to customize your website. Fill in the fields with your details.

![set configuration details](/static/images/uploads/netlify-deploy-step2.png)
![set configuration details](/src/static/images/uploads/netlify-deploy-step2.png)

You can also edit these details later in your Netlify admin.
These settings are available:
Expand Down Expand Up @@ -91,13 +91,13 @@ These settings are available:
<td>your main contact email (optional)</td>
<td>[email protected]</td>
<td>N/A</td>
</tr>
</tr>
<tr>
<td><code>META_TELEPHONE</code></td>
<td>your main contact phone number (optional)</td>
<td>+01 23 456 789 00</td>
<td>N/A</td>
</tr>
</tr>
</tbody>
</table>

Expand All @@ -109,11 +109,11 @@ When the site is published, you'll see a live green link under the site title.

You can set a custom domain (like "www.yoursite.com") in your Netlify site settings. From your site's main admin page, select Domain Settings:

![domain settings](/static/images/uploads/netlify-deploy-step3.png)
![domain settings](/src/static/images/uploads/netlify-deploy-step3.png)

By default you'll get a domain like `yoursite.netlify.com` - to connect a custom one you own, click on "add custom domain":

![add custom domain](/static/images/uploads/netlify-deploy-step4.png)
![add custom domain](/src/static/images/uploads/netlify-deploy-step4.png)

For more information on how to do this, [see the Netlify docs](https://docs.netlify.com/domains-https/custom-domains/).

Expand All @@ -123,11 +123,11 @@ The last step is to configure the built-in CMS, so you can edit the site's conte

The first thing to enable is the Netlify "Identity" service. This allows users to log in with an email address and password. In your main dashboard, select "Identity", then click on "Enable Identity".

![enable identity](/static/images/uploads/netlify-deploy-step5.png)
![enable identity](/src/static/images/uploads/netlify-deploy-step5.png)

The CMS needs a way to connect to your Github account. To do this, go to Settings > Identity > Services. You'll see an option to enable "Git Gateway". Click the button and follow the instructions from there.

![enable git gateway](/static/images/uploads/netlify-deploy-step6.png)
![enable git gateway](/src/static/images/uploads/netlify-deploy-step6.png)

After you're set up, create a new user by inviting yourself via email. You can then log in at `www.your-site.com/admin`.

Expand All @@ -142,7 +142,7 @@ If you feel comfortable setting up a local development environment, you can cust
* Installing `Node` and `npm` packages on a local machine
* Running basic commands on the command line
* Writing content in markdown files
* Basic understanding of static site generators like [Eleventy](https://11ty.dev) (optional)
* Basic understanding of static site generators like [Eleventy](https://11ty.dev) (optional)

### Getting Started

Expand All @@ -155,7 +155,7 @@ $ rm -rf .git
$ git init
```

The build process requires [Node](https://nodejs.org/en/) v10 or higher on your system.
The build process requires [Node](https://nodejs.org/en/) v10 or higher on your system.
To install the dependencies, run `npm install` in the root directory, where the `package.json` file is located. The project is now ready for development.

### Local Development
Expand All @@ -172,6 +172,6 @@ To customize the site, edit `src/data/meta.js` with your details, or set the cor

The easiest way to deploy is by forking [this repository](https://github.com/maxboeck/emergency-site) and deploying it to Netlify. You can do that by clicking this button:

[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/maxboeck/emergency-site)
[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/maxboeck/emergency-site)

If you don't want to use Netlify, you can also host the site on your own server or on cloud infrastructure like an S3 Bucket. In that case, set up your own process to host the generated output folder `dist` at your domain.
If you don't want to use Netlify, you can also host the site on your own server or on cloud infrastructure like an S3 Bucket. In that case, set up your own process to host the generated output folder `dist` at your domain.