diff --git a/website/Attachments.md b/website/Attachments.md index 72b62cfe..6eaed88b 100644 --- a/website/Attachments.md +++ b/website/Attachments.md @@ -9,5 +9,22 @@ To create an attachment, you have a few options: All options will prompt you for a file name to use to store the attachment, and then include the attachment as an embedded image (if it was an image) or link to the file. +# Linking +Attachments can be linked to in two ways: +* Via the regular link syntax: `[link text](attachment.pdf)`. URLs here are relative to the page, so on a page named `MyFolder/Hello`, `[link text](attachment.pdf)` would refer to an attachment stored in `MyFolder/attachment.pdf`. +* Via the wiki link syntax: `[[attachment.pdf]]`. These paths are absolute and relative to your space’s root, just like regular page links. That is: on a page `MyFolder/Hello` an attachment link `[[attachment.pdf]]` would link to the file `attachment.pdf` in the space’s root folder. + +# Embedding +Images can also be embedded using the [[#Linking]] syntax, but prefixed with an `!`: + +* `![alternate text](image.png)` +* `![[image.png]]` + +These follow the same relative/absolute path rules as links described before. + +In addition, images can be _sized_ using the following syntax: +* Specifying only a width: `![Alt text|300](image.png)` or `![[image.png|300]]` +* Specifying both width and height: `![Hello|300x300](image.png)` or `![[image.png|300x300]]` + # Management SilverBullet [does not currently support](https://github.com/silverbulletmd/silverbullet/issues/72) any operations like renaming or deleting of attachments. You’ll have to do this outside of SilverBullet somehow. \ No newline at end of file diff --git a/website/CHANGELOG.md b/website/CHANGELOG.md index f6108b24..229540b6 100644 --- a/website/CHANGELOG.md +++ b/website/CHANGELOG.md @@ -6,7 +6,13 @@ release. ## Edge _These features are not yet properly released, you need to use [the edge builds](https://community.silverbullet.md/t/living-on-the-edge-builds/27) to try them._ -* Nothing new since 0.7.7 yet! +* Attachments are now indexed, and smartly moved when pages are renamed (by onespaceman) +* Images can now be resized: [[Attachments#Embedding]] (initial work done by [Florent](https://github.com/silverbulletmd/silverbullet/pull/833), later adapted by onespaceman) +* Super^script^ and Sub~script~ are now supported (by [MrMugame](https://github.com/silverbulletmd/silverbullet/pull/879)) +* Added a {[Delete Line]} command (by [pihentagy](https://github.com/silverbulletmd/silverbullet/pull/866)) +* The `#boot` PWA loading the last opened page feature is back (put `#boot` at the end of your SilverBullet URL to auto load the last opened page) +* Numerous other bug fixes (thanks MrMugame and onespaceman) +* Added Erlang support ---