Skip to content

Commit

Permalink
bump to version 0.6.0
Browse files Browse the repository at this point in the history
closes #6
  • Loading branch information
erykwalder committed Jan 31, 2022
1 parent b9875b3 commit 7bc0f62
Show file tree
Hide file tree
Showing 5 changed files with 88 additions and 11 deletions.
78 changes: 70 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,20 +25,81 @@ Code blocks can also be constructed manually, and some functionality requires it
All the fields in the code block can be seen below:

```quoth
path: [[Filename#Heading#^blockid]]
path: [[Filename#Heading]]
ranges: "Hello " to "world.", "Foobar" to "Bizzbaz"
join: " -- "
display: inline
show: author, title
```

| Line | Syntax | Description | Default |
| --------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ---------- |
| `path` | `[[filename]]`, `[[file#heading]]`, or `[[file#^blockid]]` | **Required.** The path to the content that you want to include, like an internal obsidian link. | None |
| `ranges` | `"text" to "text"` or `line:col to line:col` | The part of the document you would like to embed. Multiple ranges can be joined with `,`. | None |
| `join` | `"; "` | How to combine multiple ranges. | `" ... "` |
| `display` | `embedded` or `inline` | How to display the embed. | `embedded` |
| `show` | `author` and/or `title` | Whether to include the source author or title. Multiple options can be joined with `,`. | None |
### Fields

> #### `path`
>
> **Syntax:** `[[filename#subpath]]`
>
> **subpath syntax**:
>
> - A heading: `#Some heading`
> - A block id: `#^blockid`
> - A list item: `#-Some list item`
>
> **Default:** None
>
> **Description:** **Required**. The path to the content you want to include,
> formatted like an obsidian link. Additionally supports specifying a list
> item. Multiple headings or multiple list items can be chained in the subpath.
> #### `ranges`
>
> **Syntax:** `range, range`
>
> **range syntax:**
>
> - `"text" to "text"`
> - `"whole quote"`
> - `line:col to line:col`
> - `after "text"`
> - `after line:col`
>
> **Default:** None
>
> **Description:** A subselection of the path you would like to embed.
> Multiple ranges are joined by `, `.
> #### `join`
>
> **Syntax:** `"string"`
>
> **Default:** `" ... "`
>
> **Description:** How to combine multiple ranges.
> This field is only used if there are 2 or more ranges specified.
> #### `display`
>
> **Syntax:**
>
> - `embedded`
> - `inline`
>
> **Default:** `embedded`
>
> **Description:** How to display the embed.
> #### `show`
>
> **Syntax:** `option, option`
>
> **options:**
>
> - `author`
> - `title`
>
> **Default:** None
>
> **Description:** Whether to include the source author or title.
> Multiple options can be joined with `, `.
### Deprecated Fields

Expand All @@ -55,6 +116,7 @@ There are currently some limitations to the current implementation:
- Copying from preview mode only works if the underlying markdown can be
reconstructed.
Things like mathjax are not currently handled.
You can always copy from source/live mode.
- The embedded content cannot contain another quoth code block,
because that could lead to infinite recursion.
- Rendering relies on an async call to Obsidian's renderMarkdown API,
Expand Down
14 changes: 14 additions & 0 deletions changelog.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,19 @@
# Changelog

### version 0.6.0

New Features:

- Scoping embeds to list items.
- `after` ranges which will embed everything after a
position or after a string.
- A new command to replace blockquotes with embeds
from a source file.

Fixes:

- Support tilde `~` code blocks.

### version 0.5.0

New Features:
Expand Down
2 changes: 1 addition & 1 deletion manifest.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"id": "quoth",
"name": "Quoth",
"version": "0.5.0",
"version": "0.6.0",
"minAppVersion": "0.12.9",
"description": "More flexible embedding. Embed precise selections, inline embeds, optionally include author and title.",
"authorUrl": "https://github.com/erykwalder/quoth",
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "quoth",
"version": "0.5.0",
"version": "0.6.0",
"description": "Obsidian Embed Plugin",
"main": "main.js",
"repository": "https://github.com/erykwalder/quoth",
Expand Down
3 changes: 2 additions & 1 deletion versions.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,6 @@
"0.2.1": "0.12.19",
"0.3.0": "0.12.19",
"0.4.0": "0.12.19",
"0.5.0": "0.12.19"
"0.5.0": "0.12.19",
"0.6.0": "0.13.23"
}

0 comments on commit 7bc0f62

Please sign in to comment.