Revert "chore: Linting for markdown and js"
This reverts commit 1c92e0f655.
This commit is contained in:
joostdecock
parent
994874fa72
commit
cba1ab19c8
6627 changed files with 25791 additions and 24211 deletions
|
|
@ -1,15 +1,12 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Code of Conduct
|
title: Code of Conduct
|
||||||
for: contributors
|
for: contributors
|
||||||
icons:
|
icons:
|
||||||
|
- face
|
||||||
* face
|
- heart
|
||||||
* heart
|
|
||||||
about: |
|
about: |
|
||||||
FreeSewing's code of conduct is based on the [contributor covenant](https://www.contributor-covenant.org/)
|
FreeSewing's code of conduct is based on the [contributor covenant](https://www.contributor-covenant.org/)
|
||||||
|
---
|
||||||
***
|
|
||||||
|
|
||||||
<ReadMore title="The FreeSewing Code of Conduct" />
|
<ReadMore title="The FreeSewing Code of Conduct" />
|
||||||
|
|
||||||
|
|
@ -23,7 +20,6 @@ This Code of Conduct is an almost verbatim copy of the [Contributor Covenant][ho
|
||||||
available at [http://contributor-covenant.org/version/2/0][version]
|
available at [http://contributor-covenant.org/version/2/0][version]
|
||||||
|
|
||||||
[homepage]: http://contributor-covenant.org
|
[homepage]: http://contributor-covenant.org
|
||||||
|
|
||||||
[version]: http://contributor-covenant.org/version/2/0/
|
[version]: http://contributor-covenant.org/version/2/0/
|
||||||
|
|
||||||
</Note>
|
</Note>
|
||||||
|
|
|
||||||
|
|
@ -1,16 +1,13 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Correction
|
title: Correction
|
||||||
order: 10
|
order: 10
|
||||||
---------
|
---
|
||||||
|
|
||||||
##### Community Impact
|
##### Community Impact
|
||||||
|
|
||||||
Use of inappropriate language or other behavior
|
Use of inappropriate language or other behavior
|
||||||
deemed unprofessional or unwelcome in the community.
|
deemed unprofessional or unwelcome in the community.
|
||||||
|
|
||||||
##### Consequence
|
##### Consequence
|
||||||
|
|
||||||
A private, written warning from community leaders,
|
A private, written warning from community leaders,
|
||||||
providing clarity around the nature of the violation and an
|
providing clarity around the nature of the violation and an
|
||||||
explanation of why the behavior was inappropriate.
|
explanation of why the behavior was inappropriate.
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Enforcement Guidelines
|
title: Enforcement Guidelines
|
||||||
order: 60
|
order: 60
|
||||||
---------
|
---
|
||||||
|
|
||||||
Community leaders will follow these Community Impact Guidelines
|
Community leaders will follow these Community Impact Guidelines
|
||||||
in determining the consequences for any action they deem
|
in determining the consequences for any action they deem
|
||||||
|
|
|
||||||
|
|
@ -1,16 +1,13 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Permanent ban
|
title: Permanent ban
|
||||||
order: 40
|
order: 40
|
||||||
---------
|
---
|
||||||
|
|
||||||
##### Community Impact
|
##### Community Impact
|
||||||
|
|
||||||
Demonstrating a pattern of violation of
|
Demonstrating a pattern of violation of
|
||||||
community standards, including sustained inappropriate behavior,
|
community standards, including sustained inappropriate behavior,
|
||||||
harassment of an individual, or aggression toward or
|
harassment of an individual, or aggression toward or
|
||||||
disparagement of classes of individuals.
|
disparagement of classes of individuals.
|
||||||
|
|
||||||
##### Consequence
|
##### Consequence
|
||||||
|
|
||||||
A permanent ban from any sort of public interaction within the community.
|
A permanent ban from any sort of public interaction within the community.
|
||||||
|
|
|
||||||
|
|
@ -1,16 +1,13 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Temporary ban
|
title: Temporary ban
|
||||||
order: 30
|
order: 30
|
||||||
---------
|
---
|
||||||
|
|
||||||
##### Community Impact
|
##### Community Impact
|
||||||
|
|
||||||
A serious violation of community standards,
|
A serious violation of community standards,
|
||||||
including sustained inappropriate behavior.
|
including sustained inappropriate behavior.
|
||||||
|
|
||||||
##### Consequence
|
##### Consequence
|
||||||
|
|
||||||
A temporary ban from any sort of interaction or
|
A temporary ban from any sort of interaction or
|
||||||
public communication with the community for a specified period
|
public communication with the community for a specified period
|
||||||
of time.
|
of time.
|
||||||
|
|
@ -20,3 +17,4 @@ involved, including unsolicited interaction with those enforcing
|
||||||
the Code of Conduct, is allowed during this period.
|
the Code of Conduct, is allowed during this period.
|
||||||
|
|
||||||
Violating these terms may lead to a permanent ban.
|
Violating these terms may lead to a permanent ban.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,16 +1,13 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Warning
|
title: Warning
|
||||||
order: 20
|
order: 20
|
||||||
---------
|
---
|
||||||
|
|
||||||
##### Community Impact
|
##### Community Impact
|
||||||
|
|
||||||
A violation through a single incident or series of actions.
|
A violation through a single incident or series of actions.
|
||||||
|
|
||||||
##### Consequence
|
##### Consequence
|
||||||
|
A warning with consequences for continued behavior.
|
||||||
A warning with consequences for continued behavior.\
|
|
||||||
No interaction with the people involved, including unsolicited
|
No interaction with the people involved, including unsolicited
|
||||||
interaction with those enforcing the Code of Conduct, for a
|
interaction with those enforcing the Code of Conduct, for a
|
||||||
specified period of time. This includes avoiding interactions
|
specified period of time. This includes avoiding interactions
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Enforcement responsibilities
|
title: Enforcement responsibilities
|
||||||
order: 30
|
order: 30
|
||||||
---------
|
---
|
||||||
|
|
||||||
Community leaders are responsible for clarifying and enforcing our standards
|
Community leaders are responsible for clarifying and enforcing our standards
|
||||||
of acceptable behavior and will take appropriate and fair corrective action
|
of acceptable behavior and will take appropriate and fair corrective action
|
||||||
|
|
|
||||||
|
|
@ -1,16 +1,16 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Enforcement
|
title: Enforcement
|
||||||
order: 50
|
order: 50
|
||||||
---------
|
---
|
||||||
|
|
||||||
Instances of abusive, harassing, or otherwise unacceptable behavior
|
Instances of abusive, harassing, or otherwise unacceptable behavior
|
||||||
may be reported to the community leaders responsible for enforcement:
|
may be reported to the community leaders responsible for enforcement:
|
||||||
|
|
||||||
* Joost De Cock (joost@joost.at)
|
- Joost De Cock (joost@joost.at)
|
||||||
* Sorcha Ní Dhubhghaill (nidhubhs@gmail.com)
|
- Sorcha Ní Dhubhghaill (nidhubhs@gmail.com)
|
||||||
|
|
||||||
All complaints will be reviewed and investigated promptly and fairly.
|
All complaints will be reviewed and investigated promptly and fairly.
|
||||||
|
|
||||||
All community leaders are obligated to respect the privacy and
|
All community leaders are obligated to respect the privacy and
|
||||||
security of the reporter of any incident.
|
security of the reporter of any incident.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Our pledge
|
title: Our pledge
|
||||||
order: 10
|
order: 10
|
||||||
---------
|
---
|
||||||
|
|
||||||
We as members, contributors, and leaders of the FreeSewing community pledge
|
We as members, contributors, and leaders of the FreeSewing community pledge
|
||||||
to make participation in our community a harassment-free experience for everyone.
|
to make participation in our community a harassment-free experience for everyone.
|
||||||
|
|
@ -14,3 +13,4 @@ religion, or sexual identity and orientation.
|
||||||
|
|
||||||
We pledge to act and interact in ways that contribute to an open, welcoming,
|
We pledge to act and interact in ways that contribute to an open, welcoming,
|
||||||
diverse, inclusive, and healthy community.
|
diverse, inclusive, and healthy community.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,21 +1,20 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Our standards
|
title: Our standards
|
||||||
order: 20
|
order: 20
|
||||||
---------
|
---
|
||||||
|
|
||||||
Examples of behavior that contributes to a positive environment for our community include:
|
Examples of behavior that contributes to a positive environment for our community include:
|
||||||
|
|
||||||
* Demonstrating empathy and kindness toward other people
|
- Demonstrating empathy and kindness toward other people
|
||||||
* Being respectful of differing opinions, viewpoints, and experiences
|
- Being respectful of differing opinions, viewpoints, and experiences
|
||||||
* Giving and gracefully accepting constructive feedback
|
- Giving and gracefully accepting constructive feedback
|
||||||
* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
|
- Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
|
||||||
* Focusing on what is best not just for us as individuals, but for the overall community
|
- Focusing on what is best not just for us as individuals, but for the overall community
|
||||||
|
|
||||||
Examples of unacceptable behavior include:
|
Examples of unacceptable behavior include:
|
||||||
|
|
||||||
* The use of sexualized language or imagery, and sexual attention or advances of any kind
|
- The use of sexualized language or imagery, and sexual attention or advances of any kind
|
||||||
* Trolling, insulting or derogatory comments, and personal or political attacks
|
- Trolling, insulting or derogatory comments, and personal or political attacks
|
||||||
* Public or private harassment
|
- Public or private harassment
|
||||||
* Publishing others’ private information, such as a physical or email address, without their explicit permission
|
- Publishing others’ private information, such as a physical or email address, without their explicit permission
|
||||||
* Other conduct which could reasonably be considered inappropriate in a professional setting
|
- Other conduct which could reasonably be considered inappropriate in a professional setting
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Scope
|
title: Scope
|
||||||
order: 40
|
order: 40
|
||||||
---------
|
---
|
||||||
|
|
||||||
This Code of Conduct applies within all FreeSewing community spaces, and also applies
|
This Code of Conduct applies within all FreeSewing community spaces, and also applies
|
||||||
when an individual is officially representing the FreeSewing community in public spaces.
|
when an individual is officially representing the FreeSewing community in public spaces.
|
||||||
|
|
@ -10,3 +9,4 @@ when an individual is officially representing the FreeSewing community in public
|
||||||
Examples of representing our community include using an official e-mail address,
|
Examples of representing our community include using an official e-mail address,
|
||||||
posting via an official social media account, or acting as an appointed representative
|
posting via an official social media account, or acting as an appointed representative
|
||||||
at an online or offline event.
|
at an online or offline event.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: For contributors
|
title: For contributors
|
||||||
order: 1110
|
order: 1110
|
||||||
-----------
|
---
|
||||||
|
|
||||||
Thank you for being part of our community, and for wanting to contribute! ❤️
|
Thank you for being part of our community, and for wanting to contribute! ❤️
|
||||||
|
|
||||||
|
|
@ -13,8 +12,8 @@ We would love to have you on board, but before we get to that, let's look at wha
|
||||||
|
|
||||||
##### Contributor requirements
|
##### Contributor requirements
|
||||||
|
|
||||||
* Please respect [our community standards](https://freesewing.org/docs/various/community-standards/)
|
- Please respect [our community standards](https://freesewing.org/docs/various/community-standards/)
|
||||||
* As a contributor, you must uphold [our Code of Conduct](/contributors/code-of-conduct/)
|
- As a contributor, you must uphold [our Code of Conduct](/contributors/code-of-conduct/)
|
||||||
|
|
||||||
</Note>
|
</Note>
|
||||||
|
|
||||||
|
|
@ -24,12 +23,14 @@ With that out of the way, here's a few more things that are *good to know*:
|
||||||
|
|
||||||
##### Did you know?
|
##### Did you know?
|
||||||
|
|
||||||
* Nobody gets paid to work on/for FreeSewing. We are a 100% volunteer organisation.
|
- Nobody gets paid to work on/for FreeSewing. We are a 100% volunteer organisation.
|
||||||
* We have patrons who support us financially, but all the money that comes in goes to charity --
|
- We have patrons who support us financially, but all the money that comes in goes to charity --
|
||||||
See our [revenue pledge](https://freesewing.org/docs/various/pledge/) for details
|
See our [revenue pledge](https://freesewing.org/docs/various/pledge/) for details
|
||||||
|
|
||||||
</Tip>
|
</Tip>
|
||||||
|
|
||||||
|
|
||||||
With the formalities out of the way, please continue
|
With the formalities out of the way, please continue
|
||||||
to [Ways to contribute](/contributors/ways-to-contribute)
|
to [Ways to contribute](/contributors/ways-to-contribute)
|
||||||
or [Where to get help](/contributors/help/).
|
or [Where to get help](/contributors/help/).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,16 +1,13 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Where to get help
|
title: Where to get help
|
||||||
for: contributors
|
for: contributors
|
||||||
icons:
|
icons:
|
||||||
|
- help
|
||||||
* help
|
- discord
|
||||||
* discord
|
|
||||||
about: |
|
about: |
|
||||||
Our [chatrooms on Discord](https://discord.freesewing.org/) are the best place to
|
Our [chatrooms on Discord](https://discord.freesewing.org/) are the best place to
|
||||||
ask questions or share your feedback
|
ask questions or share your feedback
|
||||||
|
---
|
||||||
***
|
|
||||||
|
|
||||||
Our [chatrooms on Discord](https://discord.freesewing.org/) are the best place to
|
Our [chatrooms on Discord](https://discord.freesewing.org/) are the best place to
|
||||||
ask questions or share your feedback.
|
ask questions or share your feedback.
|
||||||
|
|
@ -19,8 +16,11 @@ Many of the FreeSewing contributors hang out there, and since we're spread over
|
||||||
different parts of the world, you're likely to find somebody there who can answer
|
different parts of the world, you're likely to find somebody there who can answer
|
||||||
your question(s) at any given moment.
|
your question(s) at any given moment.
|
||||||
|
|
||||||
|
|
||||||
<Tip>
|
<Tip>
|
||||||
|
|
||||||
If you want to report a problem, please [create an issue](https://github.com/freesewing/freesewing/issues/new).
|
If you want to report a problem, please [create an issue](https://github.com/freesewing/freesewing/issues/new).
|
||||||
|
|
||||||
</Tip>
|
</Tip>
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Backend
|
||||||
## title: Backend
|
---
|
||||||
|
|
||||||
[The FreeSewing backend](https://backend.freesewing.org/) handles all user data for freesewing.org.
|
[The FreeSewing backend](https://backend.freesewing.org/) handles all user data for freesewing.org.
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
***
|
---
|
||||||
|
title: Commit
|
||||||
## title: Commit
|
---
|
||||||
|
|
||||||
A [commit](https://github.com/git-guides/git-commit) is made every time somebody published an update to our source code.
|
A [commit](https://github.com/git-guides/git-commit) is made every time somebody published an update to our source code.
|
||||||
|
|
||||||
The words is also used as a verb as in *to commit changes*.
|
The words is also used as a verb as in _to commit changes_.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Contributor call (fscc)
|
||||||
## title: Contributor call (fscc)
|
---
|
||||||
|
|
||||||
The FreeSewing Contributor Call (fscc) is a
|
The FreeSewing Contributor Call (fscc) is a
|
||||||
bi-weekly conference call/zoom meeting with the FreeSewing contributors.
|
bi-weekly conference call/zoom meeting with the FreeSewing contributors.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Contributor
|
||||||
## title: Contributor
|
---
|
||||||
|
|
||||||
Anybody who contributes to FreeSewing in a material way. Either with code contributions,
|
Anybody who contributes to FreeSewing in a material way. Either with code contributions,
|
||||||
or community building, or pattern design, and so on.
|
or community building, or pattern design, and so on.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Design/Pattern
|
||||||
## title: Design/Pattern
|
---
|
||||||
|
|
||||||
The terms **pattern** and **design** somewhat overlap and their exact meaning
|
The terms **pattern** and **design** somewhat overlap and their exact meaning
|
||||||
depends on the context.
|
depends on the context.
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Developer
|
||||||
## title: Developer
|
---
|
||||||
|
|
||||||
Anybody who works with software code or wants to learn to do so.
|
Anybody who works with software code or wants to learn to do so.
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
***
|
---
|
||||||
|
title: Discord
|
||||||
## title: Discord
|
---
|
||||||
|
|
||||||
The name of our chat provider that powers our chat at https://discord.freesewing.org/
|
The name of our chat provider that powers our chat at https://discord.freesewing.org/
|
||||||
|
|
||||||
When you hear *discord* just think *chat*.
|
When you hear _discord_ just think _chat_.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Editor
|
||||||
## title: Editor
|
---
|
||||||
|
|
||||||
A person who contributs to/with content. Either by writing blog posts or documentation,
|
A person who contributs to/with content. Either by writing blog posts or documentation,
|
||||||
or posts for social media. But it can also be video editing or making illustrations.
|
or posts for social media. But it can also be video editing or making illustrations.
|
||||||
|
|
|
||||||
|
|
@ -1,14 +1,11 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Terminology
|
title: Terminology
|
||||||
icons:
|
icons:
|
||||||
|
- logo
|
||||||
* logo
|
- terms
|
||||||
* terms
|
|
||||||
for: contributors
|
for: contributors
|
||||||
about: Terms and definitions that will help you navigate the world of FreeSewing
|
about: Terms and definitions that will help you navigate the world of FreeSewing
|
||||||
|
---
|
||||||
***
|
|
||||||
|
|
||||||
Below is a list of terms you may come across when working with FreeSewing with a
|
Below is a list of terms you may come across when working with FreeSewing with a
|
||||||
link to a brief description:
|
link to a brief description:
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Express
|
||||||
## title: Express
|
---
|
||||||
|
|
||||||
[Express](https://expressjs.com/) is a web framework for NodeJS.
|
[Express](https://expressjs.com/) is a web framework for NodeJS.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: freesewing.dev
|
||||||
## title: freesewing.dev
|
---
|
||||||
|
|
||||||
Our website for developers.
|
Our website for developers.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: freesewing.org
|
||||||
## title: freesewing.org
|
---
|
||||||
|
|
||||||
Our website for makers.
|
Our website for makers.
|
||||||
|
|
||||||
|
|
@ -19,7 +19,7 @@ built with Gatsby.
|
||||||
|
|
||||||
## i18n
|
## i18n
|
||||||
|
|
||||||
Short of *internationalisation*. within the context of FreeSewing, this mostly
|
Short of _internationalisation_. within the context of FreeSewing, this mostly
|
||||||
means translation, but can also relate to other intenationalisation concerns such
|
means translation, but can also relate to other intenationalisation concerns such
|
||||||
as the type of units to use, or paper sizes, and so on.
|
as the type of units to use, or paper sizes, and so on.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: FreeSewing
|
||||||
## title: FreeSewing
|
---
|
||||||
|
|
||||||
FreeSewing refers to the community-driven open source project.
|
FreeSewing refers to the community-driven open source project.
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Frontend
|
||||||
## title: Frontend
|
---
|
||||||
|
|
||||||
A user-facing interface. Can refer to one of our websites, or our development environment.
|
A user-facing interface. Can refer to one of our websites, or our development environment.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Gatsby
|
||||||
## title: Gatsby
|
---
|
||||||
|
|
||||||
[Gatsby](https://www.gatsbyjs.com/) is a static-site generator for React.
|
[Gatsby](https://www.gatsbyjs.com/) is a static-site generator for React.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
***
|
---
|
||||||
|
title: i18n
|
||||||
|
---
|
||||||
|
|
||||||
## title: i18n
|
Short for _internationalisation_. Within the context of FreeSewing, this mostly
|
||||||
|
|
||||||
Short for *internationalisation*. Within the context of FreeSewing, this mostly
|
|
||||||
means translation, but can also relate to other internationalisation concerns such
|
means translation, but can also relate to other internationalisation concerns such
|
||||||
as the type of units to use, or paper sizes, and so on.
|
as the type of units to use, or paper sizes, and so on.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Issue
|
||||||
## title: Issue
|
---
|
||||||
|
|
||||||
An issue is a sort of support ticket. It can be a bug report, a feature request, a question
|
An issue is a sort of support ticket. It can be a bug report, a feature request, a question
|
||||||
or problem report.
|
or problem report.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Javascript
|
||||||
## title: Javascript
|
---
|
||||||
|
|
||||||
The programming language in which FreeSewing is written. It can run in your
|
The programming language in which FreeSewing is written. It can run in your
|
||||||
browser, as well as outside of it with Node JS.
|
browser, as well as outside of it with Node JS.
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Made-to-measure
|
||||||
## title: Made-to-measure
|
---
|
||||||
|
|
||||||
Made to someone's (body) measurements, rather than based on specific sizes.
|
Made to someone's (body) measurements, rather than based on specific sizes.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Markdown
|
||||||
## title: Markdown
|
---
|
||||||
|
|
||||||
A plain text markup format that is easy to read for computers and humans alike.
|
A plain text markup format that is easy to read for computers and humans alike.
|
||||||
It's a way to write things in plain text, yet make them look pretty in HTML.
|
It's a way to write things in plain text, yet make them look pretty in HTML.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Monorepo
|
||||||
## title: Monorepo
|
---
|
||||||
|
|
||||||
A monorepo is an organisational approach to software development where rather than
|
A monorepo is an organisational approach to software development where rather than
|
||||||
having a multitude of repositories, a number of different software pieces are bundled
|
having a multitude of repositories, a number of different software pieces are bundled
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Node
|
||||||
## title: Node
|
---
|
||||||
|
|
||||||
Node (or NodeJS) is a Javascript runtime that allows to use the language outside the browser.
|
Node (or NodeJS) is a Javascript runtime that allows to use the language outside the browser.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Parametric pattern design
|
||||||
## title: Parametric pattern design
|
---
|
||||||
|
|
||||||
A design approach whereby sewing patterns are contructed based on parameters,
|
A design approach whereby sewing patterns are contructed based on parameters,
|
||||||
and can adapt automatically when those parameters change.
|
and can adapt automatically when those parameters change.
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Patron
|
||||||
## title: Patron
|
---
|
||||||
|
|
||||||
A person who supports FreeSewing financially.
|
A person who supports FreeSewing financially.
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Plugin
|
||||||
## title: Plugin
|
---
|
||||||
|
|
||||||
An extension to FreeSewing core that provides an extra feature of functionality.
|
An extension to FreeSewing core that provides an extra feature of functionality.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Pull request
|
||||||
## title: Pull request
|
---
|
||||||
|
|
||||||
A pull request is a proposal to commit changes to a repository.
|
A pull request is a proposal to commit changes to a repository.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: React
|
||||||
## title: React
|
---
|
||||||
|
|
||||||
[React](https://reactjs.org/) is a Javascript framework to build user interfaces on the web.
|
[React](https://reactjs.org/) is a Javascript framework to build user interfaces on the web.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Repo
|
||||||
## title: Repo
|
---
|
||||||
|
|
||||||
Short for [repository](/contributors/terms/repository/).
|
Short for [repository](/contributors/terms/repository/).
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Repository
|
||||||
## title: Repository
|
---
|
||||||
|
|
||||||
We develop our software collaboratively, and all code is available in Github in so-called repositories.
|
We develop our software collaboratively, and all code is available in Github in so-called repositories.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,9 @@
|
||||||
***
|
---
|
||||||
|
title: Tiler
|
||||||
## title: Tiler
|
---
|
||||||
|
|
||||||
The FreeSewing tiler is responsible for taking a pattern and splitting it into different
|
The FreeSewing tiler is responsible for taking a pattern and splitting it into different
|
||||||
pages so it can be printed.
|
pages so it can be printed.
|
||||||
|
|
||||||
The tiler is a backend service that is independent from the main FreeSewing backend.
|
The tiler is a backend service that is independent from the main FreeSewing backend.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Translator
|
||||||
## title: Translator
|
---
|
||||||
|
|
||||||
Somebody who helps with our i18n efforts by translating from English to other languages.
|
Somebody who helps with our i18n efforts by translating from English to other languages.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Body ambassador
|
||||||
## title: Body ambassador
|
---
|
||||||
|
|
||||||
Maybe you’re unusually short or tall.
|
Maybe you’re unusually short or tall.
|
||||||
Maybe you have a bit of a pot belly or very large breasts.
|
Maybe you have a bit of a pot belly or very large breasts.
|
||||||
|
|
@ -8,3 +8,4 @@ Maybe you have a disability that requires fit adjustments.
|
||||||
|
|
||||||
Whatever it is, if you represent a minority fitting issue you could
|
Whatever it is, if you represent a minority fitting issue you could
|
||||||
represent this minority to make sure their needs are heard and understood.
|
represent this minority to make sure their needs are heard and understood.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Community building
|
||||||
## title: Community building
|
---
|
||||||
|
|
||||||
The FreeSewing community resides [on Discord](https://discord.freesewing.org/).
|
The FreeSewing community resides [on Discord](https://discord.freesewing.org/).
|
||||||
Just being there to answer questions and chat with other people is a valuable part of community building.
|
Just being there to answer questions and chat with other people is a valuable part of community building.
|
||||||
|
|
@ -8,3 +8,4 @@ Just being there to answer questions and chat with other people is a valuable pa
|
||||||
We also can be found [in plenty of other places](https://freesewing.org/community/where/) where we'd love to have you join us.
|
We also can be found [in plenty of other places](https://freesewing.org/community/where/) where we'd love to have you join us.
|
||||||
|
|
||||||
Apart from being present in chat rooms and social media, you could also take on some responsibility on one or more platforms.
|
Apart from being present in chat rooms and social media, you could also take on some responsibility on one or more platforms.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Design sewing patterns
|
||||||
## title: Design sewing patterns
|
---
|
||||||
|
|
||||||
Everybody wants us to add more patterns. But somebody has to design them.
|
Everybody wants us to add more patterns. But somebody has to design them.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,8 @@
|
||||||
***
|
---
|
||||||
|
title: Develop sewing patterns
|
||||||
## title: Develop sewing patterns
|
---
|
||||||
|
|
||||||
You could program new designs for FreeSewing.
|
You could program new designs for FreeSewing.
|
||||||
If you're not afraid of Javascript and are happy to team up with a designer,
|
If you're not afraid of Javascript and are happy to team up with a designer,
|
||||||
you could work on a new pattern together.
|
you could work on a new pattern together.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Devops
|
||||||
## title: Devops
|
---
|
||||||
|
|
||||||
We have use a lot of automation from Github actions to automated deployment on Netlify.
|
We have use a lot of automation from Github actions to automated deployment on Netlify.
|
||||||
We also have some Ansible playbooks to run maintenance tasks.
|
We also have some Ansible playbooks to run maintenance tasks.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Ways to contribute
|
||||||
## title: Ways to contribute
|
---
|
||||||
|
|
||||||
<Tip>
|
<Tip>
|
||||||
|
|
||||||
|
|
@ -32,3 +32,6 @@ We are happy to provide guidance to anyone who wants to learn,
|
||||||
especially when doing so enables upwards social mobility.
|
especially when doing so enables upwards social mobility.
|
||||||
|
|
||||||
</Note>
|
</Note>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,7 @@
|
||||||
***
|
---
|
||||||
|
title: Make illustrations
|
||||||
## title: Make illustrations
|
---
|
||||||
|
|
||||||
Our documentation can always use some more/better illustrations to help people figure out how
|
Our documentation can always use some more/better illustrations to help people figure out how
|
||||||
to make our patterns into garments.
|
to make our patterns into garments.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,8 @@
|
||||||
***
|
---
|
||||||
|
title: Language ambassador
|
||||||
## title: Language ambassador
|
---
|
||||||
|
|
||||||
You could represent FreeSewing in a non-English community.
|
You could represent FreeSewing in a non-English community.
|
||||||
There, you can help answer questions or triage problem reports.
|
There, you can help answer questions or triage problem reports.
|
||||||
Or you can point out where translations are missing.
|
Or you can point out where translations are missing.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Pattern amabassador
|
||||||
## title: Pattern amabassador
|
---
|
||||||
|
|
||||||
You could take charge of a specific FreeSewing design/pattern.
|
You could take charge of a specific FreeSewing design/pattern.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Pattern testing
|
||||||
## title: Pattern testing
|
---
|
||||||
|
|
||||||
You could make (a muslin for) our patterns prior to release to make sure everything is ok.
|
You could make (a muslin for) our patterns prior to release to make sure everything is ok.
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Project management
|
||||||
## title: Project management
|
---
|
||||||
|
|
||||||
There's a lot going on within the FreeSewing project and it's easy to forget about something.
|
There's a lot going on within the FreeSewing project and it's easy to forget about something.
|
||||||
|
|
||||||
|
|
@ -9,6 +9,7 @@ organize milestones, and so on.
|
||||||
|
|
||||||
This is helpful in more than one way:
|
This is helpful in more than one way:
|
||||||
|
|
||||||
* It reduces the cognitive load of the people implementing changes because they don't have to worry about forgetting things
|
- It reduces the cognitive load of the people implementing changes because they don't have to worry about forgetting things
|
||||||
* It increases transparency by making it clear what sort of things are being worked on
|
- It increases transparency by making it clear what sort of things are being worked on
|
||||||
* It gives us that good feeling of closing the issue when the task is done
|
- It gives us that good feeling of closing the issue when the task is done
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Proofreading
|
||||||
## title: Proofreading
|
---
|
||||||
|
|
||||||
You could check the original English text of translations for typos and/or grammar mistakes.
|
You could check the original English text of translations for typos and/or grammar mistakes.
|
||||||
You could propose improvements and watch over a consistent style and tone across FreeSewing’s documentation and written text.
|
You could propose improvements and watch over a consistent style and tone across FreeSewing’s documentation and written text.
|
||||||
|
|
|
||||||
|
|
@ -1,9 +1,9 @@
|
||||||
***
|
---
|
||||||
|
title: Report bugs
|
||||||
## title: Report bugs
|
---
|
||||||
|
|
||||||
Bugs are tracked as [GitHub issues](https://guides.github.com/features/issues/).
|
Bugs are tracked as [GitHub issues](https://guides.github.com/features/issues/).
|
||||||
Create an issue [in our monorepo](https://github.com/freesewing/freesewing/issues/new?assignees=\&labels=%F0%9F%90%9B+bug\&template=bug-report.md\&title=Bug+report) if you've found one.
|
Create an issue [in our monorepo](https://github.com/freesewing/freesewing/issues/new?assignees=&labels=%F0%9F%90%9B+bug&template=bug-report.md&title=Bug+report) if you've found one.
|
||||||
|
|
||||||
Explain the problem and include additional details to help maintainers reproduce the problem:
|
Explain the problem and include additional details to help maintainers reproduce the problem:
|
||||||
|
|
||||||
|
|
@ -15,3 +15,4 @@ Provide more context by answering these questions:
|
||||||
|
|
||||||
* **Did the problem start happening recently** (e.g. it worked fine before but since the latest update it doesn't)
|
* **Did the problem start happening recently** (e.g. it worked fine before but since the latest update it doesn't)
|
||||||
* **Can you reliably reproduce the issue?** If not, provide details about how often the problem happens and under which conditions it normally happens.
|
* **Can you reliably reproduce the issue?** If not, provide details about how often the problem happens and under which conditions it normally happens.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,9 @@
|
||||||
***
|
---
|
||||||
|
title: Showcase our patterns
|
||||||
## title: Showcase our patterns
|
---
|
||||||
|
|
||||||
Anytime somebody has made one of our patterns, we like to showcase it on [freesewing.org](https://freesewing.org/showcase/).
|
Anytime somebody has made one of our patterns, we like to showcase it on [freesewing.org](https://freesewing.org/showcase/).
|
||||||
|
|
||||||
Unpublished showcases are tracked as [GitHub issues](https://guides.github.com/features/issues/).
|
Unpublished showcases are tracked as [GitHub issues](https://guides.github.com/features/issues/).
|
||||||
Create an issue [in our monorepo](https://github.com/freesewing/freesewing/issues/new?assignees=\&labels=%F0%9F%91%8D+good+first+issue%2C+%F0%9F%93%B8+showcase%2C+%F0%9F%A4%97+community\&template=showcase-template.md\&title=Create+showcase+from+this+content) when you've made one of our patterns, or have come across pictures from another maker who did.
|
Create an issue [in our monorepo](https://github.com/freesewing/freesewing/issues/new?assignees=&labels=%F0%9F%91%8D+good+first+issue%2C+%F0%9F%93%B8+showcase%2C+%F0%9F%A4%97+community&template=showcase-template.md&title=Create+showcase+from+this+content) when you've made one of our patterns, or have come across pictures from another maker who did.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Writing for freesewing.dev
|
||||||
## title: Writing for freesewing.dev
|
---
|
||||||
|
|
||||||
You could write documentation for freesewing.dev, our developers website.
|
You could write documentation for freesewing.dev, our developers website.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Technical writing
|
||||||
## title: Technical writing
|
---
|
||||||
|
|
||||||
<ReadMore list />
|
<ReadMore list />
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Writing for freesewing.org
|
||||||
## title: Writing for freesewing.org
|
---
|
||||||
|
|
||||||
You could write documentation for freesewing.org, our makers website.
|
You could write documentation for freesewing.org, our makers website.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,7 @@
|
||||||
***
|
---
|
||||||
|
title: Translation
|
||||||
## title: Translation
|
---
|
||||||
|
|
||||||
You could translate FreeSewing into one of its additional languages
|
You could translate FreeSewing into one of its additional languages
|
||||||
(French, German, Dutch, Spanish). Or if you’re ambitious, add a new one.
|
(French, German, Dutch, Spanish). Or if you’re ambitious, add a new one.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,14 +1,15 @@
|
||||||
***
|
---
|
||||||
|
title: Triage issues
|
||||||
## title: Triage issues
|
---
|
||||||
|
|
||||||
Triaging issues is a great way to get involved in FreeSewing. You can do tasks such as:
|
Triaging issues is a great way to get involved in FreeSewing. You can do tasks such as:
|
||||||
|
|
||||||
* Making sure issues are properly labeled
|
- Making sure issues are properly labeled
|
||||||
* Ensuring they have a good title that explains the issue in brief
|
- Ensuring they have a good title that explains the issue in brief
|
||||||
* Assigning issues to people to make sure they are tended to
|
- Assigning issues to people to make sure they are tended to
|
||||||
* Keeping an eye on stale issues, and either updating or closing them
|
- Keeping an eye on stale issues, and either updating or closing them
|
||||||
* Assigning issues to milestones so we can plan our releases
|
- Assigning issues to milestones so we can plan our releases
|
||||||
|
|
||||||
All FreeSewing contributors have triage permissions that allows them to do this.
|
All FreeSewing contributors have triage permissions that allows them to do this.
|
||||||
If you don't have the rights, or bump into any issues, [reach out to us on Discord](https://discord.freesewing.org).
|
If you don't have the rights, or bump into any issues, [reach out to us on Discord](https://discord.freesewing.org).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: UI / UX Webdesign
|
||||||
## title: UI / UX Webdesign
|
---
|
||||||
|
|
||||||
You could help us make our website and tools pretty and improve the user experience.
|
You could help us make our website and tools pretty and improve the user experience.
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: The freesewing backend
|
||||||
## title: The freesewing backend
|
---
|
||||||
|
|
||||||
<Fixme>Under construction</Fixme>
|
<Fixme>Under construction</Fixme>
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: The freesewing.dev website
|
||||||
## title: The freesewing.dev website
|
---
|
||||||
|
|
||||||
<Fixme>Under construction</Fixme>
|
<Fixme>Under construction</Fixme>
|
||||||
|
|
|
||||||
|
|
@ -1,17 +1,16 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: For developers
|
title: For developers
|
||||||
order: 1120
|
order: 1120
|
||||||
-----------
|
---
|
||||||
|
|
||||||
Welcome to the FreeSewing documentation for developers.
|
Welcome to the FreeSewing documentation for developers.
|
||||||
|
|
||||||
Our core library is a toolbox for parametric sewing pattern design.
|
Our core library is a toolbox for parametric sewing pattern design.
|
||||||
Here's some of the most relevant reference documentation:
|
Here's some of the most relevant reference documentation:
|
||||||
|
|
||||||
* [Core API reference](/reference/api/)
|
- [Core API reference](/reference/api/)
|
||||||
* [Pattern configuration file](/reference/config/)
|
- [Pattern configuration file](/reference/config/)
|
||||||
* [Settings](/reference/settings/)
|
- [Settings](/reference/settings/)
|
||||||
|
|
||||||
We have a [Pattern design tutorial](/tutorials/pattern-design/) that is a
|
We have a [Pattern design tutorial](/tutorials/pattern-design/) that is a
|
||||||
good way to familiarize yourself with the FreeSewing platform.
|
good way to familiarize yourself with the FreeSewing platform.
|
||||||
|
|
@ -24,3 +23,5 @@ If you are interested the FreeSewing project as a whole, the following links
|
||||||
cover different aspects of our setup:
|
cover different aspects of our setup:
|
||||||
|
|
||||||
<ReadMore list />
|
<ReadMore list />
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: The freesewing.org website
|
||||||
## title: The freesewing.org website
|
---
|
||||||
|
|
||||||
<Fixme>Under construction</Fixme>
|
<Fixme>Under construction</Fixme>
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: The freesewing on-demand tiler
|
||||||
## title: The freesewing on-demand tiler
|
---
|
||||||
|
|
||||||
<Fixme>Under construction</Fixme>
|
<Fixme>Under construction</Fixme>
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Our tile command line tool
|
||||||
## title: Our tile command line tool
|
---
|
||||||
|
|
||||||
<Fixme>Under construction</Fixme>
|
<Fixme>Under construction</Fixme>
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Content sources
|
||||||
## title: Content sources
|
---
|
||||||
|
|
||||||
As an editor, you need to know where you can find/edit what type of content.
|
As an editor, you need to know where you can find/edit what type of content.
|
||||||
|
|
||||||
|
|
@ -10,9 +10,9 @@ Our [freesewing monorepo](https://github/freesewing/freesewing) holds the majori
|
||||||
|
|
||||||
Here you can find:
|
Here you can find:
|
||||||
|
|
||||||
* Content for freesewing.org: in the `markdown/org` folder
|
- Content for freesewing.org: in the `markdown/org` folder
|
||||||
* Content for freesewing.dev: in the `markdown/dev` folder
|
- Content for freesewing.dev: in the `markdown/dev` folder
|
||||||
* Strings used throughout the software: in the `packages/i18n/src/locales` folder
|
- Strings used throughout the software: in the `packages/i18n/src/locales` folder
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
|
|
||||||
|
|
@ -29,13 +29,14 @@ The rest will be created automatically.
|
||||||
|
|
||||||
FreeSewing uses [the Strapi content management system](https://strapi.io/) as a headless content management system for various posts:
|
FreeSewing uses [the Strapi content management system](https://strapi.io/) as a headless content management system for various posts:
|
||||||
|
|
||||||
* For blog posts on freesewing.org
|
- For blog posts on freesewing.org
|
||||||
* For showcase posts on freesewing.org
|
- For showcase posts on freesewing.org
|
||||||
* For blog posts on freesewing.dev
|
- For blog posts on freesewing.dev
|
||||||
* For newsletter editions
|
- For newsletter editions
|
||||||
|
|
||||||
The Strapi instance is available at [posts.freesewing.org](https://posts.freesewing.org)
|
The Strapi instance is available at [posts.freesewing.org](https://posts.freesewing.org)
|
||||||
|
|
||||||
|
|
||||||
## Emails sent from our backend
|
## Emails sent from our backend
|
||||||
|
|
||||||
The last bit of content is emails that are sent out from our backend systems.
|
The last bit of content is emails that are sent out from our backend systems.
|
||||||
|
|
|
||||||
|
|
@ -1,17 +1,16 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: For editors
|
title: For editors
|
||||||
order: 1130
|
order: 1130
|
||||||
-----------
|
---
|
||||||
|
|
||||||
Content is king, and as an *editor* content is your baby.
|
Content is king, and as an *editor* content is your baby.
|
||||||
|
|
||||||
We have a few different [content sources](/editor/content-sources/) that all have their own
|
We have a few different [content sources](/editor/content-sources/) that all have their own
|
||||||
specific use-cases, but in general content is one of:
|
specific use-cases, but in general content is one of:
|
||||||
|
|
||||||
* 95% **Markdown**: Used for the vast majority of our content.
|
- 95% **Markdown**: Used for the vast majority of our content.
|
||||||
* 4% **YAML**: Used for the internationalisation of our software.
|
- 4% **YAML**: Used for the internationalisation of our software.
|
||||||
* 1% **HTML**: Used in specific places that don't requires internationalisation.
|
- 1% **HTML**: Used in specific places that don't requires internationalisation.
|
||||||
|
|
||||||
You guessed it, if you know how to work with markdown, you are already covering
|
You guessed it, if you know how to work with markdown, you are already covering
|
||||||
95% of all our content. As such, [our Markdown guide](/editors/markdown/) is mandatory
|
95% of all our content. As such, [our Markdown guide](/editors/markdown/) is mandatory
|
||||||
|
|
|
||||||
|
|
@ -1,11 +1,11 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Adding a blog post
|
title: Adding a blog post
|
||||||
for: editors
|
for: editors
|
||||||
------------
|
---
|
||||||
|
|
||||||
Blog posts have been migrated to [Strapi](https://strapi.io/), a headless CMS system.
|
Blog posts have been migrated to [Strapi](https://strapi.io/), a headless CMS system.
|
||||||
|
|
||||||
Our strapi instance can be accessed at [posts.freesewing.org](https://posts.freesewing.org/).
|
Our strapi instance can be accessed at [posts.freesewing.org](https://posts.freesewing.org/).
|
||||||
|
|
||||||
If you don't have a Strapi account (yet), [reach out to us on Discord](https://discord.freesewing.org).
|
If you don't have a Strapi account (yet), [reach out to us on Discord](https://discord.freesewing.org).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
***
|
---
|
||||||
|
title: Common tasks for editors
|
||||||
## title: Common tasks for editors
|
---
|
||||||
|
|
||||||
Below is a list of commons tasks for editors
|
Below is a list of commons tasks for editors
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: About frontmatter
|
title: About frontmatter
|
||||||
order: 10
|
order: 10
|
||||||
---------
|
---
|
||||||
|
|
||||||
Frontmatter is a way to add metadata to markdown documents.
|
Frontmatter is a way to add metadata to markdown documents.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Working with frontmatter
|
title: Working with frontmatter
|
||||||
for: editors
|
for: editors
|
||||||
------------
|
---
|
||||||
|
|
||||||
Frontmatter is a way to add metadata to markdown documents.
|
Frontmatter is a way to add metadata to markdown documents.
|
||||||
It is used extensively on freesewing.org and freesewing.dev alike.
|
It is used extensively on freesewing.org and freesewing.dev alike.
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Lists or arrays
|
title: Lists or arrays
|
||||||
order: 30
|
order: 30
|
||||||
---------
|
---
|
||||||
|
|
||||||
Values are typically text or numbers, but you can also make it a list or array.
|
Values are typically text or numbers, but you can also make it a list or array.
|
||||||
There's two types of syntax for this:
|
There's two types of syntax for this:
|
||||||
|
|
@ -14,3 +13,4 @@ categories:
|
||||||
- anothercat
|
- anothercat
|
||||||
- somethingelse
|
- somethingelse
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Mult-line text
|
title: Mult-line text
|
||||||
order: 40
|
order: 40
|
||||||
---------
|
---
|
||||||
|
|
||||||
To add multi-line text in frontmatter, use a `|` character,
|
To add multi-line text in frontmatter, use a `|` character,
|
||||||
and prefix the lines by spaces:
|
and prefix the lines by spaces:
|
||||||
|
|
@ -12,3 +11,6 @@ about: |
|
||||||
This is a multi-line text
|
This is a multi-line text
|
||||||
that will be assigned to the about key
|
that will be assigned to the about key
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Structure
|
title: Structure
|
||||||
order: 20
|
order: 20
|
||||||
---------
|
---
|
||||||
|
|
||||||
Frontmatter is made up of `key: value` pairs.
|
Frontmatter is made up of `key: value` pairs.
|
||||||
The value must be quoted if you use a `:` in it to avoid problems parsing the key values:
|
The value must be quoted if you use a `:` in it to avoid problems parsing the key values:
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Adding a showcase on freesewing.org
|
title: Adding a showcase on freesewing.org
|
||||||
for: editors
|
for: editors
|
||||||
------------
|
---
|
||||||
|
|
||||||
Showcase posts have been migrated to [Strapi](https://strapi.io/), a headless CMS system.
|
Showcase posts have been migrated to [Strapi](https://strapi.io/), a headless CMS system.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Code and code blocks
|
title: Code and code blocks
|
||||||
order: 80
|
order: 80
|
||||||
---------
|
---
|
||||||
|
|
||||||
Especially for our developer documentation, there's a lot of times we include source code
|
Especially for our developer documentation, there's a lot of times we include source code
|
||||||
in the documentation.
|
in the documentation.
|
||||||
|
|
@ -10,20 +9,26 @@ You can make these look pretty by using a code block.
|
||||||
|
|
||||||
The basic use is to wrap your code in three backtick characters on a line:
|
The basic use is to wrap your code in three backtick characters on a line:
|
||||||
|
|
||||||
|
````
|
||||||
```
|
```
|
||||||
let me = 'you'
|
let me = 'you'
|
||||||
```
|
```
|
||||||
|
````
|
||||||
|
|
||||||
Gives you:
|
Gives you:
|
||||||
|
|
||||||
|
```
|
||||||
let me = 'you'
|
let me = 'you'
|
||||||
|
```
|
||||||
|
|
||||||
This is a generic code block. But we also support syntax highlighting.
|
This is a generic code block. But we also support syntax highlighting.
|
||||||
To do so, add the language specifier after the opening backticks:
|
To do so, add the language specifier after the opening backticks:
|
||||||
|
|
||||||
|
````
|
||||||
```js
|
```js
|
||||||
let me = 'you'
|
let me = 'you'
|
||||||
```
|
```
|
||||||
|
````
|
||||||
|
|
||||||
To get:
|
To get:
|
||||||
|
|
||||||
|
|
@ -33,13 +38,16 @@ let me = 'you'
|
||||||
|
|
||||||
The following language codes are supported:
|
The following language codes are supported:
|
||||||
|
|
||||||
* `js` for Javascript code
|
- `js` for Javascript code
|
||||||
* `md` for Markdown
|
- `md` for Markdown
|
||||||
* `html` for HTML
|
- `html` for HTML
|
||||||
* `svg` for SVG
|
- `svg` for SVG
|
||||||
* `bash` for Bash or shell scripts
|
- `bash` for Bash or shell scripts
|
||||||
* `mdx` for MDX
|
- `mdx` for MDX
|
||||||
* `jsx` for JSX
|
- `jsx` for JSX
|
||||||
* `json` for JSON
|
- `json` for JSON
|
||||||
* `js-error` for a Javascript error
|
- `js-error` for a Javascript error
|
||||||
* `js-trace` for a Javascript stack trace
|
- `js-trace` for a Javascript stack trace
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,10 +1,9 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Custom components
|
title: Custom components
|
||||||
order: 90
|
order: 90
|
||||||
---------
|
---
|
||||||
|
|
||||||
The way we render markdown on our websites is through the use of [MDX](https://mdxjs.com/).\
|
The way we render markdown on our websites is through the use of [MDX](https://mdxjs.com/).
|
||||||
This allows us to extend Markdown with our own so-called *custom components*.
|
This allows us to extend Markdown with our own so-called *custom components*.
|
||||||
|
|
||||||
Such custom components allow us to put things in Markdown content that would
|
Such custom components allow us to put things in Markdown content that would
|
||||||
|
|
@ -21,3 +20,4 @@ line at the start and finish. If you don't, the custom component will still work
|
||||||
content inside of it will not be parsed as Markdown.
|
content inside of it will not be parsed as Markdown.
|
||||||
|
|
||||||
</Tip>
|
</Tip>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Example
|
title: Example
|
||||||
order: 90
|
order: 90
|
||||||
---------
|
---
|
||||||
|
|
||||||
Embeds an example -- a part of our `example` pattern that is used to
|
Embeds an example -- a part of our `example` pattern that is used to
|
||||||
illustrate the core API documentation.
|
illustrate the core API documentation.
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Fixme
|
title: Fixme
|
||||||
order: 40
|
order: 40
|
||||||
---------
|
---
|
||||||
|
|
||||||
```md
|
```md
|
||||||
<Fixme>
|
<Fixme>
|
||||||
|
|
@ -16,7 +15,7 @@ I indicate that something needs work or improvement
|
||||||
<Fixme>
|
<Fixme>
|
||||||
|
|
||||||
##### I am a FIXME
|
##### I am a FIXME
|
||||||
|
|
||||||
I indicate that something needs work or improvement
|
I indicate that something needs work or improvement
|
||||||
|
|
||||||
</Fixme>
|
</Fixme>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Hashtag
|
title: Hashtag
|
||||||
order: 60
|
order: 60
|
||||||
---------
|
---
|
||||||
|
|
||||||
Typically used on our community pages:
|
Typically used on our community pages:
|
||||||
|
|
||||||
|
|
@ -10,6 +9,8 @@ Typically used on our community pages:
|
||||||
<Hashtag tag='WeAreFreeSewing' />
|
<Hashtag tag='WeAreFreeSewing' />
|
||||||
```
|
```
|
||||||
|
|
||||||
Adds our *community* font and color:
|
Adds our _community_ font and color:
|
||||||
|
|
||||||
<Hashtag tag='WeAreFreeSewing' />
|
<Hashtag tag='WeAreFreeSewing' />
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Note
|
title: Note
|
||||||
order: 10
|
order: 10
|
||||||
---------
|
---
|
||||||
|
|
||||||
```md
|
```md
|
||||||
<Note>
|
<Note>
|
||||||
|
|
@ -16,7 +15,6 @@ I point out things
|
||||||
<Note>
|
<Note>
|
||||||
|
|
||||||
##### I am a note
|
##### I am a note
|
||||||
|
|
||||||
I point out things
|
I point out things
|
||||||
|
|
||||||
</Note>
|
</Note>
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: ReadMore
|
title: ReadMore
|
||||||
order: 70
|
order: 70
|
||||||
---------
|
---
|
||||||
|
|
||||||
This component will list child pages of the current page.
|
This component will list child pages of the current page.
|
||||||
|
|
||||||
|
|
@ -11,7 +10,6 @@ This component will list child pages of the current page.
|
||||||
```md
|
```md
|
||||||
<ReadMore />
|
<ReadMore />
|
||||||
```
|
```
|
||||||
|
|
||||||
<ReadMore />
|
<ReadMore />
|
||||||
|
|
||||||
##### With custom title
|
##### With custom title
|
||||||
|
|
@ -21,7 +19,6 @@ You can customize the title by passing a `title` prop:
|
||||||
```md
|
```md
|
||||||
<ReadMore title='Example pages'/>
|
<ReadMore title='Example pages'/>
|
||||||
```
|
```
|
||||||
|
|
||||||
<ReadMore title='Example pages'/>
|
<ReadMore title='Example pages'/>
|
||||||
|
|
||||||
##### As a list
|
##### As a list
|
||||||
|
|
@ -32,7 +29,6 @@ prop which returns the pages as a list:
|
||||||
```md
|
```md
|
||||||
<ReadMore list />
|
<ReadMore list />
|
||||||
```
|
```
|
||||||
|
|
||||||
<ReadMore list />
|
<ReadMore list />
|
||||||
|
|
||||||
##### As a recursive list
|
##### As a recursive list
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Example page 1
|
||||||
## title: Example page 1
|
---
|
||||||
|
|
||||||
This page is here to illustrate the use of [the `ReadMore` custom component](/editors/markdown/custom-components/readmore/).
|
This page is here to illustrate the use of [the `ReadMore` custom component](/editors/markdown/custom-components/readmore/).
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Example page 2
|
||||||
## title: Example page 2
|
---
|
||||||
|
|
||||||
This page is here to illustrate the use of [the `ReadMore` custom component](/editors/markdown/custom-components/readmore/).
|
This page is here to illustrate the use of [the `ReadMore` custom component](/editors/markdown/custom-components/readmore/).
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Sub-example page 1
|
||||||
## title: Sub-example page 1
|
---
|
||||||
|
|
||||||
This page is here to illustrate the use of [the `ReadMore` custom component](/editors/markdown/custom-components/readmore/).
|
This page is here to illustrate the use of [the `ReadMore` custom component](/editors/markdown/custom-components/readmore/).
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
***
|
---
|
||||||
|
title: Sub-example page 2
|
||||||
## title: Sub-example page 2
|
---
|
||||||
|
|
||||||
This page is here to illustrate the use of [the `ReadMore` custom component](/editors/markdown/custom-components/readmore/).
|
This page is here to illustrate the use of [the `ReadMore` custom component](/editors/markdown/custom-components/readmore/).
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Tip
|
title: Tip
|
||||||
order: 20
|
order: 20
|
||||||
---------
|
---
|
||||||
|
|
||||||
```md
|
```md
|
||||||
<Tip>
|
<Tip>
|
||||||
|
|
@ -16,7 +15,7 @@ I give great advice
|
||||||
<Tip>
|
<Tip>
|
||||||
|
|
||||||
##### I am a tip
|
##### I am a tip
|
||||||
|
|
||||||
I give great advice
|
I give great advice
|
||||||
|
|
||||||
</Tip>
|
</Tip>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Warning
|
title: Warning
|
||||||
order: 30
|
order: 30
|
||||||
---------
|
---
|
||||||
|
|
||||||
```md
|
```md
|
||||||
<Warning>
|
<Warning>
|
||||||
|
|
@ -16,7 +15,7 @@ Ignore me at your own peril
|
||||||
<Warning>
|
<Warning>
|
||||||
|
|
||||||
##### I am a warning
|
##### I am a warning
|
||||||
|
|
||||||
Ignore me at your own peril
|
Ignore me at your own peril
|
||||||
|
|
||||||
</Warning>
|
</Warning>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: YouTube
|
title: YouTube
|
||||||
order: 50
|
order: 50
|
||||||
---------
|
---
|
||||||
|
|
||||||
This components will embed videos and playlists responsively.
|
This components will embed videos and playlists responsively.
|
||||||
|
|
||||||
|
|
@ -25,3 +24,4 @@ Embed a playlist:
|
||||||
```
|
```
|
||||||
|
|
||||||
<YouTube id='RDRz6ShSftDlI' playlist />
|
<YouTube id='RDRz6ShSftDlI' playlist />
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,21 +1,18 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Markdown guide
|
title: Markdown guide
|
||||||
for: contributors
|
for: contributors
|
||||||
order: 900
|
order: 900
|
||||||
icons:
|
icons:
|
||||||
|
- edit
|
||||||
* edit
|
- markdown
|
||||||
* markdown
|
|
||||||
about: |
|
about: |
|
||||||
A quick primer on Markdown, the markup language you didn't know you needed in your life
|
A quick primer on Markdown, the markup language you didn't know you needed in your life
|
||||||
goals:
|
goals:
|
||||||
* Understand what Markdown is
|
- Understand what Markdown is
|
||||||
* Format text with Markdown, including headers, paragraphs, links, and lists
|
- Format text with Markdown, including headers, paragraphs, links, and lists
|
||||||
* Learn how to include images and tables
|
- Learn how to include images and tables
|
||||||
* Learn about the different custom components
|
- Learn about the different custom components
|
||||||
|
---
|
||||||
***
|
|
||||||
|
|
||||||
Markdown is a lightweight markup language with plain text formatting syntax.
|
Markdown is a lightweight markup language with plain text formatting syntax.
|
||||||
It is designed to be easily readable by humans, and computers alike.
|
It is designed to be easily readable by humans, and computers alike.
|
||||||
|
|
@ -29,3 +26,4 @@ In this guide, we'll look at the following topics:
|
||||||
|
|
||||||
This will be enough to get you started. If you'd like to learn more,
|
This will be enough to get you started. If you'd like to learn more,
|
||||||
visit [markdownguide.org](https://www.markdownguide.org/).
|
visit [markdownguide.org](https://www.markdownguide.org/).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Headings
|
title: Headings
|
||||||
order: 40
|
order: 40
|
||||||
---------
|
---
|
||||||
|
|
||||||
Prefix your line with a number of `#` characters to determine the header level.
|
Prefix your line with a number of `#` characters to determine the header level.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Images
|
title: Images
|
||||||
order: 70
|
order: 70
|
||||||
---------
|
---
|
||||||
|
|
||||||
Images are like links, just prefix them with an exclamation mark.
|
Images are like links, just prefix them with an exclamation mark.
|
||||||
The part between square brackets is the image caption or alt-text.
|
The part between square brackets is the image caption or alt-text.
|
||||||
|
|
@ -20,3 +19,4 @@ text where you are including the image. That way, you just need to specify
|
||||||
the image name, and not the path to its location.
|
the image name, and not the path to its location.
|
||||||
|
|
||||||
</Tip>
|
</Tip>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,18 +1,16 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Italics and bold
|
title: Italics and bold
|
||||||
order: 30
|
order: 30
|
||||||
---------
|
---
|
||||||
|
|
||||||
```md
|
```md
|
||||||
You can make text *italic* or **bold**
|
You can make text *italic* or **bold**
|
||||||
by wrapping it in 1 or 2 asterisk respectively.
|
by wrapping it in 1 or 2 asterisk respectively.
|
||||||
```
|
```
|
||||||
|
|
||||||
You can make text *italic* or **bold** by wrapping it in 1 or 2 asterisk respectively:
|
You can make text *italic* or **bold** by wrapping it in 1 or 2 asterisk respectively:
|
||||||
|
|
||||||
```md
|
```md
|
||||||
Alternatively, you can also use underscores to mark _italic_ or __bold__.
|
Alternatively, you can also use underscores to mark _italic_ or __bold__.
|
||||||
```
|
```
|
||||||
|
Alternatively, you can also use underscores to mark _italic_ or __bold__.
|
||||||
|
|
||||||
Alternatively, you can also use underscores to mark *italic* or **bold**.
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,7 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Line breaks
|
title: Line breaks
|
||||||
order: 20
|
order: 20
|
||||||
---------
|
---
|
||||||
|
|
||||||
If you want to force a linebreak, but not a new paragraph,
|
If you want to force a linebreak, but not a new paragraph,
|
||||||
simply leave 2 spaces at the end of the line.
|
simply leave 2 spaces at the end of the line.
|
||||||
|
|
@ -12,5 +11,6 @@ Like
|
||||||
this.
|
this.
|
||||||
```
|
```
|
||||||
|
|
||||||
Like\
|
Like
|
||||||
this.
|
this.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,13 +1,12 @@
|
||||||
***
|
---
|
||||||
|
|
||||||
title: Links
|
title: Links
|
||||||
order: 60
|
order: 60
|
||||||
---------
|
---
|
||||||
|
|
||||||
Links combine square brackets for the link text with round brackets for the destination.
|
Links combine square brackets for the link text with round brackets for the destination.
|
||||||
|
|
||||||
```md
|
```md
|
||||||
[Like this](https://freesewing.org)
|
[Like this](https://freesewing.org)
|
||||||
```
|
```
|
||||||
|
|
||||||
[Like this](https://freesewing.org)
|
[Like this](https://freesewing.org)
|
||||||
|
|
||||||
|
|
|
||||||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Add table
Add a link
Reference in a new issue