1
0
Fork 0

feat: Flat import of markdown repo

This is a flat (without history) import of (some of) the content
from our markdown module.

We've imported this without history because the repo contains our
blog posts and showcases posts content prior to porting them to strapi.

Since this contains many images, it would balloon the size of this repo
to import the full history.

Instead, please refer to the history of the (archived) markdown repo
at: https://github.com/freesewing/markdown
This commit is contained in:
Joost De Cock 2021-08-25 16:09:31 +02:00
parent 1671a896b5
commit b34a2ee2ed
6132 changed files with 244167 additions and 0 deletions

View file

@ -0,0 +1,12 @@
---
title: Add the body of the showcase post
order: 50
---
Below the frontmatter, you can write the body of your showcase post, [using markdown](/editors/markdown/).
<Tip>
You can look at [one of the many showcases](https://github.com/freesewing/markdown/tree/develop/org/showcase) for examples.
</Tip>

View file

@ -0,0 +1,33 @@
---
title: Add the frontmatter
order: 40
---
Frontmatter is metadata that we add to the top of the file.
Please refere to [working with frontmatter](/howtos/editors/frontmatter/) is you're not sure how to use it.
The following fields need to be filled in:
| Name | Description |
| ----:| ----------- |
| `date` | **Must** be in format `YYYY-MM-DD` |
| `title` | Title of the showcase |
| `img` | Filename of the main image. Must be placed in the folder of the showcase |
| `caption` | The caption that will go below the image |
| `patterns` | An array of designs/patterns that are being showcased. Lowercase only |
| `author` | FreeSewing username of the author |
Below is an example:
```md
---
date: 2018-09-29
title: Yoga Outfit by Paul
img: showcase.jpg
caption: "Aaron and Bruce yoga set with stripes by Paul (up-side-down)"
patterns: [aaron,bruce]
author: Tiger751023
---
```
Add the frontmatter to the top of the `en.md` file.

View file

@ -0,0 +1,23 @@
---
title: Add images to the folder
order: 30
---
Add the images you want to use to the folder. Keep the following guidelines in mind:
- The main showcase picture should, if possible, be a landscape image
- The best resolution for the main image is 2000x1348 pixels
- None of the images should be larger than 2000px on their longest side
- Use lowercase for all filenames
<Note>
##### Please think twice before dropping a 7Mb image.
Git never forgets. So if you drop a couple of 7Mb images into our repo,
they will be there forever, making cloning the repo very slow.
So please resize your images before you commit your changes.
</Note>

View file

@ -0,0 +1,14 @@
---
title: Create a new file for the showcase post
order: 20
---
In the folder you just created, create a new empty file, and name it `en.md`.
<Note>
While we support translation, we do not support adding original content in
any language other than English. This is why the file **must** be named
`en.md` and be written in English.
</Note>

View file

@ -0,0 +1,18 @@
---
title: Create a new folder for the showcase post
order: 10
---
Our [markdown repository](https://github.com/freesewing/markdown/) holds all content
for both freesewing.org and freesewing.dev.
The content for showcases on freesewing.org is in the `org/showcase` folder.
You'll find a bunch of directories here for all the existing showcases.
Create a new one keeping in mind that this will determine the URL under which the showcase
is available. So:
- No spaces
- No uppercase
- Stick to `a-z` and `-` to be safe

View file

@ -0,0 +1,82 @@
---
title: Adding a showcase on freesewing.org
for: editors
---
These are the steps required to add a new [showcase](https://freesewing.org/showcase/) to the website:
- Create a new folder in the `org/showcase` directory of [our markdown repository](https://github.com/freesewing/markdown/)
- Add an `en.md` markdown file to this folder
- Add one of more images to the folder
- Add the frontmatter to the file
- Add the body of the file
Let's look at each step in detail:
## Create a new folder for the showcase
Our [markdown repository](https://github.com/freesewing/markdown/) holds all content
for both freesewing.org and freesewing.dev.
The content for showcases on freesewing.org is in the `org/showcase` folder.
You'll find a bunch of directories here for all the existing showcases.
Create a new one keeping in mind that this will determine the URL under which the showcase
is available. So:
- No spaces
- No uppercase
- Stick to `a-z` and `-` to be safe
## Add an `en.md` file to the folder
Create an empty file in this folder and name it `en.md`.
## Add one of more images to the folder
Add the images you want to use to the folder.
<Note>We prefer if you use lowercase for all filenames</Note>
## Add the frontmatter
Frontmatter is metadata that we add to the top of the file.
Please refere to [working with frontmatter](/editors/frontmatter) is you're not sure how to use it.
The following fields need to be filled in:
| Name | Description |
| ---- | ----------- |
| `date` | Must be in format `YYYY-MM-DD` |
| `title` | Title of the showcase |
| `img` | Filename of the main image. Must be placed in the folder of the showcase |
| `caption` | The caption that will go below the image |
| `patterns` | An array of designs/patterns that are being showcased. Lowercase only |
| `author` | FreeSewing username of the author |
Below is an example:
```md
---
date: 2018-09-29
title: Yoga Outfit by Paul
img: showcase.jpg
caption: "Aaron and Bruce yoga set with stripes by Paul (up-side-down)"
patterns: [aaron,bruce]
author: Tiger751023
---
```
Add the frontmatter to the top of the `en.md` file.
## Add the body
Below the frontmatter, you can write the body of your post, [using markdown](/editors/markdown/).
<Tip>
You can look at [one of the many showcases](https://github.com/freesewing/markdown/tree/develop/org/showcase) for examples.
</Tip>