freesewing/markdown/dev/howtos/code/adding-text/en.md

---
title: Adding text
---

SVG is pretty great, but its text handling leaves much to be desired.

To abstract away the intricacies of adding text to an SVG document, FreeSewing
provides the [Point.addText()](/reference/api/point/addtext) and
[Path.addText()](/reference/api/path/addtext) methods to let you add text to
points and paths.

In addition, [the `title` macro](/reference/macros/title) not only lets you add a
title to your part, it also allows you to add notes.

## Wrapping lines

SVG does not provide any line-wrapping, so you will need to be mindful of that when you add longer text.

To facilitate this, FreeSewing will enforce a line break when you use `\n` in your text.

## Translation

Text that is added to a pattern typically requires translation. 
You should break up your text in such a way that it remains possible to translate it.

You can do that either via repeated calls to `addText()` or you can pass an array of strings, or even a nested array of strings, and FreeSewing will translate all individual pieces prior to contatenating them.

<Note compact noP>

Refer to [the `insertText` hook](/reference/hooks/inserttext#notes) for details.
</Note>
Revert "chore: Linting for markdown and js" This reverts commit 1c92e0f655c1b34e4b1f6807914529cc4d82ff81. 2021-10-17 18:26:00 +02:00			`---`
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 2021-08-25 16:09:31 +02:00			`title: Adding text`
Revert "chore: Linting for markdown and js" This reverts commit 1c92e0f655c1b34e4b1f6807914529cc4d82ff81. 2021-10-17 18:26:00 +02:00			`---`
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 2021-08-25 16:09:31 +02:00
			`SVG is pretty great, but its text handling leaves much to be desired.`

feat(markdown): Ported code howtos to v3 2022-10-12 14:42:45 +02:00			`To abstract away the intricacies of adding text to an SVG document, FreeSewing`
			`provides the [Point.addText()](/reference/api/point/addtext) and`
			`[Path.addText()](/reference/api/path/addtext) methods to let you add text to`
			`points and paths.`

chore: Updated title macro docs 2024-01-07 17:07:26 +01:00			In addition, [the `title` macro](/reference/macros/title) not only lets you add a
			`title to your part, it also allows you to add notes.`

			`## Wrapping lines`

			`SVG does not provide any line-wrapping, so you will need to be mindful of that when you add longer text.`

			To facilitate this, FreeSewing will enforce a line break when you use `\n` in your text.

			`## Translation`

			`Text that is added to a pattern typically requires translation.`
			`You should break up your text in such a way that it remains possible to translate it.`

			You can do that either via repeated calls to `addText()` or you can pass an array of strings, or even a nested array of strings, and FreeSewing will translate all individual pieces prior to contatenating them.

			`<Note compact noP>`

			Refer to [the `insertText` hook](/reference/hooks/inserttext#notes) for details.
			`</Note>`