VSinerva/freesewing
1
0
Fork 0
Code Activity

feat: Flat import of markdown repo

Browse source 
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
Download patch file Download diff file Expand all files Collapse all files

94
markdown/dev/tutorials/pattern-design/paperless-bib/de.md Normal file
View file

@ -0,0 +1,94 @@
---
title: 270|Making your pattern paperless
---
Users can request paperless patterns by setting the `paperless` setting to `true`.
We can get that value of the setting from the `part.shorthand()` method. It will be the last shorthand we need:
```js
let {
Point,
points,
Path,
paths,
measurements,
options,
macro,
complete,
snippets,
Snippet,
paperless
} = part.shorthand();
```
The idea behind *paperless patterns* is that users don't need to print your pattern in order to use it. Instead, we include dimensions on the pattern that allows them to transfer the pattern directly onto fabric, or onto an intermediate medium such as tracing paper.
In addition, FreeSewing will automatically render a grid for each pattern part with metric or imperial marcations, depending on the units requested by the user.
While the grid gets added automatically, the dimensions you have to add yourself. Thankfully, there's macros that can help you with that, specifically:
- The `hd` macro adds a horizontal dimension
- The `vd` macro adds a vertical dimension
- The `ld` macro adds a linear dimension
- The `pd` macro adds a path dimension that follows a given path<Fixme> Add links to macro docs </Fixme>
Let's look at the code:
```js
if (paperless) {
// Add dimensions
macro("hd", {
from: points.bottomLeftStart,
to: points.bottomRightEnd,
y: points.bottomLeft.y + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.bottom,
x: points.bottomRight.x + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.right,
x: points.bottomRight.x + 30
});
macro("vd", {
from: points.bottomRightStart,
to: points.tipLeftTopStart,
x: points.bottomRight.x + 45
});
macro("hd", {
from: points.left,
to: points.right,
y: points.left.y + 25
});
macro("ld", {
from: points.tipLeftBottomEnd,
to: points.tipLeftTopStart,
d: 15
});
}
```
There's a lot going on, but it's mostly repetition. Let's look at the end result, and discuss:
<Example pattern="tutorial" part="bib" caption="Your paperless bib" settings={{paperless: true}} />
We used the `hd` macro to add two horizontal dimensions:
- One at the bottom for the width of our bib
- One for the width of the neck opening
The `hd` macro takes a `from` and `to` point as well as a `y` value that says at what Y-value to draw the dimension.
We've also added three `vd` macros for the vertical dimensions on the right.
They also takes a `from` and `to` point, but expect a `x` parameter to indicate at what X-value the dimension should be drawn.
Finally, we added a `ld` macro for the linear dimension at the top that marks the width of our strap. While most dimensions are horizontal or vertical, sometimes you want a straight line from the `from` to the `to` points like in this case.
The `ld` macro takes a `d` argument (short for delta) that indicates how far the dimension should be offset from the line from the `from` to the `to` point, if at all.
Making your pattern paperless is the icing on the cake. Time to wrap up, go over what we've learned, and give some pointers on where to go from here.

104
markdown/dev/tutorials/pattern-design/paperless-bib/en.md Normal file
View file

@ -0,0 +1,104 @@
---
title: Making your pattern paperless
order: 270
---
Users can request paperless patterns by setting the `paperless` setting to `true`.
We can get that value of the setting from the `part.shorthand()` method.
It will be the last shorthand we need:
```js
let {
Point,
points,
Path,
paths,
measurements,
options,
macro,
complete,
snippets,
Snippet,
paperless
} = part.shorthand();
```
The idea behind *paperless patterns* is that users don't need to print your
pattern in order to use it.
Instead, we include dimensions on the pattern that allows them to transfer
the pattern directly onto fabric, or onto an intermediate medium such as tracing paper.
In addition, FreeSewing will automatically render a grid for each pattern part with metric or imperial
marcations, depending on the units requested by the user.
While the grid gets added automatically, the dimensions you have to add yourself.
Thankfully, there's macros that can help you with that, specifically:
- The `hd` macro adds a horizontal dimension
- The `vd` macro adds a vertical dimension
- The `ld` macro adds a linear dimension
- The `pd` macro adds a path dimension that follows a given path
<Fixme> Add links to macro docs </Fixme>
Let's look at the code:
```js
if (paperless) {
// Add dimensions
macro("hd", {
from: points.bottomLeftStart,
to: points.bottomRightEnd,
y: points.bottomLeft.y + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.bottom,
x: points.bottomRight.x + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.right,
x: points.bottomRight.x + 30
});
macro("vd", {
from: points.bottomRightStart,
to: points.tipLeftTopStart,
x: points.bottomRight.x + 45
});
macro("hd", {
from: points.left,
to: points.right,
y: points.left.y + 25
});
macro("ld", {
from: points.tipLeftBottomEnd,
to: points.tipLeftTopStart,
d: 15
});
}
```
There's a lot going on, but it's mostly repetition. Let's look at the end result, and discuss:
<Example pattern="tutorial" part="bib" caption="Your paperless bib" settings={{paperless: true}} />
We used the `hd` macro to add two horizontal dimensions:
- One at the bottom for the width of our bib
- One for the width of the neck opening
The `hd` macro takes a `from` and `to` point as well as a `y` value that says at what Y-value to draw the dimension.
We've also added three `vd` macros for the vertical dimensions on the right.
They also takes a `from` and `to` point, but expect a `x` parameter to indicate at what X-value the dimension should be drawn.
Finally, we added a `ld` macro for the linear dimension at the top that marks the width of our strap.
While most dimensions are horizontal or vertical, sometimes you want a straight line from the `from` to the `to` points like in this case.
The `ld` macro takes a `d` argument (short for delta) that indicates how far the dimension should be offset from the line from the `from` to the `to` point, if at all.
Making your pattern paperless is the icing on the cake. Time to wrap up, go over what we've learned, and give some pointers on where to go from here.

94
markdown/dev/tutorials/pattern-design/paperless-bib/es.md Normal file
View file

@ -0,0 +1,94 @@
---
title: 270|Making your pattern paperless
---
Users can request paperless patterns by setting the `paperless` setting to `true`.
We can get that value of the setting from the `part.shorthand()` method. It will be the last shorthand we need:
```js
let {
Point,
points,
Path,
paths,
measurements,
options,
macro,
complete,
snippets,
Snippet,
paperless
} = part.shorthand();
```
The idea behind *paperless patterns* is that users don't need to print your pattern in order to use it. Instead, we include dimensions on the pattern that allows them to transfer the pattern directly onto fabric, or onto an intermediate medium such as tracing paper.
In addition, FreeSewing will automatically render a grid for each pattern part with metric or imperial marcations, depending on the units requested by the user.
While the grid gets added automatically, the dimensions you have to add yourself. Thankfully, there's macros that can help you with that, specifically:
- The `hd` macro adds a horizontal dimension
- The `vd` macro adds a vertical dimension
- The `ld` macro adds a linear dimension
- The `pd` macro adds a path dimension that follows a given path<Fixme> Add links to macro docs </Fixme>
Let's look at the code:
```js
if (paperless) {
// Add dimensions
macro("hd", {
from: points.bottomLeftStart,
to: points.bottomRightEnd,
y: points.bottomLeft.y + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.bottom,
x: points.bottomRight.x + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.right,
x: points.bottomRight.x + 30
});
macro("vd", {
from: points.bottomRightStart,
to: points.tipLeftTopStart,
x: points.bottomRight.x + 45
});
macro("hd", {
from: points.left,
to: points.right,
y: points.left.y + 25
});
macro("ld", {
from: points.tipLeftBottomEnd,
to: points.tipLeftTopStart,
d: 15
});
}
```
There's a lot going on, but it's mostly repetition. Let's look at the end result, and discuss:
<Example pattern="tutorial" part="bib" caption="Your paperless bib" settings={{paperless: true}} />
We used the `hd` macro to add two horizontal dimensions:
- One at the bottom for the width of our bib
- One for the width of the neck opening
The `hd` macro takes a `from` and `to` point as well as a `y` value that says at what Y-value to draw the dimension.
We've also added three `vd` macros for the vertical dimensions on the right.
They also takes a `from` and `to` point, but expect a `x` parameter to indicate at what X-value the dimension should be drawn.
Finally, we added a `ld` macro for the linear dimension at the top that marks the width of our strap. While most dimensions are horizontal or vertical, sometimes you want a straight line from the `from` to the `to` points like in this case.
The `ld` macro takes a `d` argument (short for delta) that indicates how far the dimension should be offset from the line from the `from` to the `to` point, if at all.
Making your pattern paperless is the icing on the cake. Time to wrap up, go over what we've learned, and give some pointers on where to go from here.

94
markdown/dev/tutorials/pattern-design/paperless-bib/fr.md Normal file
View file

@ -0,0 +1,94 @@
---
title: 270|Making your pattern paperless
---
Les utilisateurs peuvent demander des patrons sans papier en réglant le paramètre `paperless` sur `true`.
Nous pouvons obtenir cette valeur du paramètre à partir de la méthode `part.shorthand()`. Cela sera le dernier raccourci dont nous aurons besoin :
```js
let {
Point,
points,
Path,
paths,
measurements,
options,
macro,
complete,
snippets,
Snippet,
paperless
} = part.shorthand();
```
The idea behind *paperless patterns* is that users don't need to print your pattern in order to use it. Au lieu de cela, nous incluons les dimensions sur le patron qui leur permettent de transférer la patron directement sur le tissu, ou sur un medium intermédiaire comme du papier carbone.
De plus, FreeSewing va automatiquement délivrer une grille pour chaque partie de patron avec des marques métriques ou impériales, selon les unités choisies par l'utilisateur.
Tandis que la grille est ajoutée automatiquement, vous aurez à ajouter les dimensions vous-mêmes. Heureusement, il existe des macros pour vous aider dans cette tâche, spécifiquement :
- La macro `hd` qui ajoute une mesure horizontale
- La macro `vd` qui ajoute une mesure verticale
- La macro `ld` qui ajoute une mesure linéaire
- La macro `pd` qui ajoute une mesure de chemin suivant ce même chemin<Fixme> Add links to macro docs </Fixme>
Jetons un coup d'oeil à ce code :
```js
if (paperless) {
// Add dimensions
macro("hd", {
from: points.bottomLeftStart,
to: points.bottomRightEnd,
y: points.bottomLeft.y + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.bottom,
x: points.bottomRight.x + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.right,
x: points.bottomRight.x + 30
});
macro("vd", {
from: points.bottomRightStart,
to: points.tipLeftTopStart,
x: points.bottomRight.x + 45
});
macro("hd", {
from: points.left,
to: points.right,
y: points.left.y + 25
});
macro("ld", {
from: points.tipLeftBottomEnd,
to: points.tipLeftTopStart,
d: 15
});
}
```
Beaucoup de choses se passent, mais elles sont répétitives. Voyons un peu le résultat final, et discutons-en :
<Example pattern="tutorial" part="bib" caption="Your paperless bib" settings={{paperless: true}} />
Nous avons utilisé la macro `hd` pour ajouter deux mesures horizontales :
- Une en bas pour la largeur de notre bavoir
- Une pour la largeur de l'encolure
La macro `hd` prend un point d'origine `from` et un point d'arrivée `to` et également une valeur `y` qui dit à quelle valeur en Y marquer cette mesure.
Nous avons également ajouté trois macros `vd` pour les mesures verticales sur la droite.
Elle prennent aussi un point de départ `from` et un point d'arrivée `to`, mais attendent un paramètre `x` pour leur indiquer à quelle valeur de X la mesure doit être marquée.
Finalement, nous avons ajouté une macro `ld` pour la mesure linéaire du haut qui marque la largeur de notre attache. Bien que la plupart des mesures soient horizontale ou verticale, parfois vous voudrez une ligne droite entre les points `from` et `to` comme dans ce cas.
La macro `ld` prend un argument `d` (pour delta) qui indique jusqu'où la mesure doit être décalée de la ligne partant du point `from` au point `to`, si besoin.
Rendre votre patron sans papier est la cerise sur le gâteau. Il est temps de faire un bilan, de voir tout ce que nous avons appris, et de donner quelques indications sur la direction à suivre à partir de là.

94
markdown/dev/tutorials/pattern-design/paperless-bib/nl.md Normal file
View file

@ -0,0 +1,94 @@
---
title: 270|Making your pattern paperless
---
Gebruikers kunnen papierloze patronen opvragen door `paperless` in te stellen als `true`.
Die waarde kan je uit de `part.shorthand()`-methode halen. Dit is de laatste shorthand die we nodig hebben:
```js
let {
Point,
points,
Path,
paths,
measurements,
options,
macro,
complete,
snippets,
Snippet,
paperless
} = part.shorthand();
```
The idea behind *paperless patterns* is that users don't need to print your pattern in order to use it. In plaats daarvan voegen we afmetingen toe op het patroon waarmee ze het patroon rechtstreeks op de stof kunnen aanduiden, of op een drager zoals patroonpapier.
Daar bovenop maakt FreeSewing automatisch een grid voor elk patroon met metrieke of imperiale aanduidingen, afhankelijk van de eenheid die de gebruiker heeft ingesteld.
Het grid wordt automatisch toegevoegd, maar de afmetingen moet je zelf toevoegen. Gelukkig zijn er macro's die je daarmee kunnen helpen, namelijk:
- De `hd`-macro voegt een horizontale afmeting toe
- De `vd`-macro voegt een verticale afmeting toe
- De `ld`-macro voegt een lineaire afmeting toe
- De `pd`-macro voegt een padafmeting toe die een specifiek pad volgt<Fixme> Add links to macro docs </Fixme>
Zo ziet dat eruit in de code:
```js
if (paperless) {
// Add dimensions
macro("hd", {
from: points.bottomLeftStart,
to: points.bottomRightEnd,
y: points.bottomLeft.y + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.bottom,
x: points.bottomRight.x + 15
});
macro("vd", {
from: points.bottomRightStart,
to: points.right,
x: points.bottomRight.x + 30
});
macro("vd", {
from: points.bottomRightStart,
to: points.tipLeftTopStart,
x: points.bottomRight.x + 45
});
macro("hd", {
from: points.left,
to: points.right,
y: points.left.y + 25
});
macro("ld", {
from: points.tipLeftBottomEnd,
to: points.tipLeftTopStart,
d: 15
});
}
```
Dat is een hele lap code, maar vooral veel herhaling. Eens kijken naar het eindresultaat:
<Example pattern="tutorial" part="bib" caption="Your paperless bib" settings={{paperless: true}} />
We hebben de `hd`-macro gebruikt om twee horizontale afmetingen toe te voegen:
- Eentje onderaan voor de breedte van het slabbetje
- Eentje voor de breedte van de halsopening
De `hd`-macro gebruikt een punt voor `from` en `to` en een `y`-waarde die aangeeft op welke Y-waarde de afmeting getekend moet worden.
We hebben drie `vd`-macro's toegevoegd voor de verticale afmetingen aan de rechterkant.
Die gebruiken ook een punt voor `from` en `to`, maar hebben een `x`-parameter nodig om aan te geven op welke X-waarde de afmeting getekend moet worden.
Als laatste hebben we een `ld`-macro toegevoegd voor de lineaire afmeting bovenaan die de breedte van het bandje aangeeft. De meeste afmetingen zijn horizontaal of verticaal, maar soms heb je een rechte lijn nodig van de punten `from` naar `to` zoals in dit geval.
De `ld`-macro gebruikt een `d`-argument (kort voor 'delta') dat aangeeft op welke afstand de afmeting verwijderd moet staan van de lijn van `from` naar `to`, als er al afstand tussen moet zitten.
Je patroon papierloos maken is de kers op de taart. Tijd om af te ronden, te overlopen wat we geleerd hebben, en je wat aanwijzingen mee te geven voor de volgende stappen.