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:
parent
1671a896b5
commit
b34a2ee2ed
6132 changed files with 244167 additions and 0 deletions
13
markdown/dev/editors/howtos/blogpost/add-body/en.md
Normal file
13
markdown/dev/editors/howtos/blogpost/add-body/en.md
Normal file
|
@ -0,0 +1,13 @@
|
|||
---
|
||||
title: Add the body of the blog post
|
||||
order: 90
|
||||
---
|
||||
|
||||
Below the frontmatter, you can write the body of your blog post, [using markdown](/editors/markdown/).
|
||||
|
||||
|
||||
<Tip>
|
||||
|
||||
You can look at [one of the many blog posts](https://github.com/freesewing/markdown/tree/develop/org/blog) for examples.
|
||||
|
||||
</Tip>
|
34
markdown/dev/editors/howtos/blogpost/add-frontmatter/en.md
Normal file
34
markdown/dev/editors/howtos/blogpost/add-frontmatter/en.md
Normal file
|
@ -0,0 +1,34 @@
|
|||
---
|
||||
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/) if 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 blog post |
|
||||
| `linktitle` | If the title is very long, you can specify an alternative title for use in menus, breadcrumbs, and so on. This field is optional. |
|
||||
| `img` | Filename of the main image. Must be placed in the folder of the showcase |
|
||||
| `caption` | The caption that will go below the image |
|
||||
| `author` | FreeSewing username of the author |
|
||||
|
||||
Below is an example:
|
||||
|
||||
```md
|
||||
---
|
||||
date: 2020-09-09
|
||||
title: FreeSewing 2.9 brings our Teagan T-shirt pattern
|
||||
linktitle: "Our latest pattern is Teagan, a fitted T-shirt"
|
||||
img: teagan2.jpg
|
||||
caption: "Photo by Alex Andrews from Pexels"
|
||||
author: joost
|
||||
---
|
||||
```
|
||||
|
||||
Add the frontmatter to the top of the `en.md` file.
|
||||
|
23
markdown/dev/editors/howtos/blogpost/add-images/en.md
Normal file
23
markdown/dev/editors/howtos/blogpost/add-images/en.md
Normal 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 blog picture should 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>
|
||||
|
14
markdown/dev/editors/howtos/blogpost/create-file/en.md
Normal file
14
markdown/dev/editors/howtos/blogpost/create-file/en.md
Normal file
|
@ -0,0 +1,14 @@
|
|||
---
|
||||
title: Create a new file for the blog 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>
|
18
markdown/dev/editors/howtos/blogpost/create-folder/en.md
Normal file
18
markdown/dev/editors/howtos/blogpost/create-folder/en.md
Normal file
|
@ -0,0 +1,18 @@
|
|||
---
|
||||
title: Create a new folder for the blog post
|
||||
order: 10
|
||||
---
|
||||
|
||||
Our [markdown repository](https://github.com/freesewing/markdown/) holds all content
|
||||
for both freesewing.org and freesewing.dev.
|
||||
|
||||
The content for blog posts on freesewing.org is in the `org/blog` folder.
|
||||
|
||||
You'll find a bunch of directories here for all the existing blog posts.
|
||||
Create a new one keeping in mind that this will determine the URL under which the post
|
||||
is available. So:
|
||||
|
||||
- No spaces
|
||||
- No uppercase
|
||||
- Stick to `a-z` and `-` to be safe
|
||||
|
15
markdown/dev/editors/howtos/blogpost/en.md
Normal file
15
markdown/dev/editors/howtos/blogpost/en.md
Normal file
|
@ -0,0 +1,15 @@
|
|||
---
|
||||
title: Adding a blog post on freesewing.org
|
||||
for: editors
|
||||
---
|
||||
|
||||
These are the steps required to add a new [blog post](https://freesewing.org/showcase/) to the website:
|
||||
|
||||
<ReadMore list />
|
||||
|
||||
- Create a new folder in the `org/blog` 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
|
||||
|
Loading…
Add table
Add a link
Reference in a new issue