OpenSourceArk/obsidian-export
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
d138c92a25
obsidian-export/CHANGES.md
Nick Groenen 05b5a56d55
Release v0.7.0
2021-04-11 16:33:03 +02:00

9.7 KiB
Raw Blame History

Changelog

v0.7.0 (2021-04-11)

New

  • Postprocessing support. [Nick Groenen]

    Add support for postprocessing of Markdown prior to writing converted notes to disk.

    Postprocessors may be used when making use of Obsidian export as a Rust library to do the following:

    1. Modify a note's Context, for example to change the destination filename or update its Frontmatter.
    2. Change a note's contents by altering MarkdownEvents.
    3. Prevent later postprocessors from running or cause a note to be skipped entirely.

    Future releases of Obsidian export may come with built-in postprocessors for users of the command-line tool to use, if general use-cases can be identified.

    For example, a future release might include functionality to make notes more suitable for the Hugo static site generator. This functionality would be implemented as a postprocessor that could be enabled through command-line flags.

Fixes

  • Also percent-encode ? in filenames. [Nick Groenen]

    A recent Obsidian update expanded the list of allowed characters in filenames, which now includes ? as well. This needs to be percent-encoded for proper links in static site generators like Hugo.

Other

v0.6.0 (2021-02-15)

New

  • Add --version flag. [Nick Groenen]

Changes

  • Don't Box FilterFn in WalkOptions. [Nick Groenen]

    Previously, filter_fn on the WalkOptions struct looked like:

    pub filter_fn: Option<Box<&'static FilterFn>>,

    This boxing was unneccesary and has been changed to:

    pub filter_fn: Option<&'static FilterFn>,

    This will only affect people who use obsidian-export as a library in other Rust programs, not users of the CLI.

    For those library users, they no longer need to supply FilterFn wrapped in a Box.

Fixes

  • Recognize notes beginning with underscores. [Nick Groenen]

    Notes with an underscore would fail to be recognized within Obsidian [[_WikiLinks]] due to the assumption that the underlying Markdown parser (pulldown_cmark) would emit the text between [[ and ]] as a single event.

    The note parser has now been rewritten to use a more reliable state machine which correctly recognizes this corner-case (and likely some others).

  • Support self-references. [Joshua Coles]

    This ensures links to headings within the same note ([[#Heading]]) resolve correctly.

Other

  • Avoid redundant "Release" in GitHub release titles. [Nick Groenen]

  • Add failing testcase for files with underscores. [Nick Groenen]

  • Add unit tests for display of ObsidianNoteReference. [Nick Groenen]

  • Add some unit tests for ObsidianNoteReference::from_str. [Nick Groenen]

  • Also run tests on pull requests. [Nick Groenen]

  • Apply clippy suggestions following rust 1.50.0. [Nick Groenen]

  • Fix infinite recursion bug with references to current file. [Joshua Coles]

  • Add tests for self-references. [Joshua Coles]

    Note as there is no support for block references at the moment, the generated link goes nowhere, however it is to a reasonable ID

  • Bump tempfile from 3.1.0 to 3.2.0. [dependabot[bot]]

    Bumps tempfile from 3.1.0 to 3.2.0.

  • Bump eyre from 0.6.3 to 0.6.5. [dependabot[bot]]

    Bumps eyre from 0.6.3 to 0.6.5.

  • Bump regex from 1.4.2 to 1.4.3. [dependabot[bot]]

    Bumps regex from 1.4.2 to 1.4.3.

v0.5.1 (2021-01-10)

Fixes

  • Find uppercased notes when referenced with lowercase. [Nick Groenen]

    This commit fixes a bug where, if a note contained uppercase characters (for example Note.md) but was referred to using lowercase ([[note]]), that note would not be found.

v0.5.0 (2021-01-05)

New

  • Add --no-recursive-embeds to break infinite recursion cycles. [Nick Groenen]

    It's possible to end up with "recursive embeds" when two notes embed each other. This happens for example when a Note A.md contains ![[Note B]] but Note B.md also contains ![[Note A]].

    By default, this will trigger an error and display the chain of notes which caused the recursion.

    Using the new --no-recursive-embeds, if a note is encountered for a second time while processing the original note, rather than embedding it again a link to the note is inserted instead to break the cycle.

    See also: https://github.com/zoni/obsidian-export/issues/1

  • Make walk options configurable on CLI. [Nick Groenen]

    By default hidden files, patterns listed in .export-ignore as well as any files ignored by git are excluded from exports. This behavior has been made configurable on the CLI using the new flags --hidden, --ignore-file and --no-git.

  • Support links referencing headings. [Nick Groenen]

    Previously, links referencing a heading ([[note#heading]]) would just link to the file name without including an anchor in the link target. Now, such references will include an appropriate #anchor attribute.

    Note that neither the original Markdown specification, nor the more recent CommonMark standard, specify how anchors should be constructed for a given heading.

    There are also some differences between the various Markdown rendering implementations.

    Obsidian-export uses the slug crate to generate anchors which should be compatible with most implementations, however your mileage may vary.

    (For example, GitHub may leave a trailing - on anchors when headings end with a smiley. The slug library, and thus obsidian-export, will avoid such dangling dashes).

  • Support embeds referencing headings. [Nick Groenen]

    Previously, partial embeds (![[note#heading]]) would always include the entire file into the source note. Now, such embeds will only include the contents of the referenced heading (and any subheadings).

    Links and embeds of arbitrary blocks remains unsupported at this time.

Changes

  • Print warnings to stderr rather than stdout. [Nick Groenen]

    Warning messages emitted when encountering broken links/references will now be printed to stderr as opposed to stdout.

Other

  • Include filter_fn field in WalkOptions debug display. [Nick Groenen]

v0.4.0 (2020-12-23)

Fixes

  • Correct relative links within embedded notes. [Nick Groenen]

    Links within an embedded note would point to other local resources relative to the filesystem location of the note being embedded.

    When a note inside a different directory would embed such a note, these links would point to invalid locations.

    Now these links are calculated relative to the top note, which ensures these links will point to the right path.

Other

  • Add brief library documentation to all public types and functions. [Nick Groenen]

v0.3.0 (2020-12-21)

New

  • Report file tree when RecursionLimitExceeded is hit. [Nick Groenen]

    This refactors the Context to maintain a list of all the files which have been processed so far in a chain of embeds. This information is then used to print a more helpful error message to users of the CLI when RecursionLimitExceeded is returned.

Changes

  • Add extra whitespace around multi-line warnings. [Nick Groenen]

    This makes errors a bit easier to distinguish after a number of warnings has been printed.

Other

  • Setup gitchangelog. [Nick Groenen]

    This adds a changelog (CHANGES.md) which is automatically generated with gitchangelog.

v0.2.0 (2020-12-13)

  • Allow custom filter function to be passed with WalkOptions. [Nick Groenen]

  • Re-export vault_contents and WalkOptions as pub from crate root. [Nick Groenen]

  • Run mdbook hook against README.md too. [Nick Groenen]

  • Update installation instructions. [Nick Groenen]

    Installation no longer requires a git repository URL now that a crate is published.

  • Add MdBook generation script and precommit hook. [Nick Groenen]

  • Add more reliable non-ASCII tetscase. [Nick Groenen]

  • Create FUNDING.yml. [Nick Groenen]

v0.1.0 (2020-11-28)

  • Public release. [Nick Groenen]