Improved ratio and relative length docs#5750
Conversation
| /// setting the width or height of a container (e.g., [block], [rect], etc.), | ||
| /// thus it is used as a part of a [relative length](relative) (because | ||
| /// internally containers use relative length for width and height fields): |
There was a problem hiding this comment.
I feel like something like this might be better:
| /// setting the width or height of a container (e.g., [block], [rect], etc.), | |
| /// thus it is used as a part of a [relative length](relative) (because | |
| /// internally containers use relative length for width and height fields): | |
| /// setting the width or height of a container (e.g., [block], [rect], etc.), | |
| /// as it can be used as part of a [relative length]($relative) to represent | |
| /// a certain percentage of the surrounding container's - or the current | |
| /// page's, if there isn't one - corresponding dimension. For example: |
There was a problem hiding this comment.
Nnoo, it sounds very complex and weird. Why there is "-" before "or"? "container's" what? I completely don't understand the "if there isn't one - corresponding dimension" part. Corresponding to what? There is no way there is nothing outside: there is always page dimensions, if there is no other container wrappers.
There was a problem hiding this comment.
I changed it a little in the new commit.
There was a problem hiding this comment.
If this is resolved, mark it as so.
Co-authored-by: PgBiel <9021226+PgBiel@users.noreply.github.com>
Co-authored-by: PgBiel <9021226+PgBiel@users.noreply.github.com>
1d04540 to
e201dc4
Compare
I think this should be moved to the contribution docs. Maybe the docs site can use MathML or something else for inline and potentially block math. Of course, the math syntax should be the one of Typst. I want to make a separate issue about this. |
|
Thanks! I shuffled some stuff around and, in the end, changed things up quite a bit, but I think what you added is still there, just some things in different shape. |
|
Looks nice. Really want to see how it looks in the rendered docs now. ;) |
Co-authored-by: PgBiel <9021226+PgBiel@users.noreply.github.com> Co-authored-by: Laurenz <laurmaedje@gmail.com>
Continues typst#5750 and typst#6862 Relates to typst#6346
Continues typst#5750 and typst#6862 Relates to typst#6346
Continues typst#5750 and typst#6862 Relates to typst#6346
Continues typst#5750 and typst#6862 Relates to typst#6346
Since we don't have a way to test the docs on the docs page (unlike rust docs) or docs on how link to different stuff work, I have no idea if all my links are valid.
I think I mentioned everything from #3098 OP in one way or another. Although, I am not sure what I should write for the relative length. And which part of the patch should be in which of the two files.
Closes #3098.