- Improve line wrapping
- Improve line wrapping and text reflow
- Support inline src blocks
- Render rich content inside drawer property values
- Improve parsing accuracy
- Fix trailing blank lines
- Recognize .avif files as images
- Render rich content inside links
- Bug fixes
- Render rich content inside markups
- Improve jumping behavior
- Render radio targets and link targets
- Linkify radio links; jump to radio targets when opened
- Introduce
OrgLocator
to allow imperative jumping to footnotes, link targets, and named elements. Place it in your widget tree underOrgController
. - Jumped-to objects are briefly highlighted
- Jumped-to objects are more reliably made visible
- Minor optimization
- Improve table rendering
- Respect the
org-pretty-entities-include-sub-superscripts
andorg-use-sub-superscripts
local variables- See also equivalent settings
subSuperscritps
andstrictSubSuperscripts
onOrgSettings
- See also equivalent settings
- Render horizontal rules
- Fix headline ellipses for headlines with no tags
- Add
onTimestampTap
callback - Fixed diary timestamp rendering
- Identify document info meta lines case-insensitively
- Style "document info" meta lines (
#+TITLE:
, etc.) accurately - Allow scrolling meta lines when
OrgSettings.deemphasizeMarkup
is enabled
- Support statistics cookies
- Allow specifying a new
restorationId
inOrgController.defaults
- Bug fixes
- Upgrade dependencies
- Detect text direction automatically
- Respect the
bidi-paragraph-direction
local variable
- Fold whitespace between headline title and tags when the headline would not fit the available width as-is
- Detect
#+LANGUAGE:
and set locale appropriately
- Support entities in superscripts and subscripts
- All headline tags are now shown when the headline is open
- Headlines are rendered without special layout (tags aligned to the right) when text reflow is disabled
- Render superscripts and subscripts. These are controlled by the same flags as entities.
- Local variables blocks, PGP blogs, and comments are now searchable
- Fix extra space under drawers
- Fix layout of inline widgets, especially images
- Fix indentation of list bodies when not using text reflow
- Add
OrgLinkWidget
- Bump org_parser to 6.1.0 with support for Org Cite
[cite:@key]
citations- Provide an
onCitationTap
callback toOrg
etc., to handle taps - Customize the color with
OrgThemeData.citationColor
- Provide an
- Bump org_parser to 6.0.0 with support for
#+TODO:
keywords. See the Advanced example in the README. - Expose TODO settings on
OrgSettings.todoSettings
- Respect "in-progress" vs "done" keyword status in org_parser AST
- Update dependencies for Flutter 3.26
onLocalSectionLinkTap
can now return the root document as well
- Add
setVisibilityOf
,adaptVisibility
methods toOrgControllerData
- Improve search behavior
- Highlight headlines of sparse query matches
- Fix various sparse query matching bugs
- Fix handling of queries in
OrgController.defaults
- Remove
OrgControllerData.search
. Supply your search query declaratively toOrgController
constructors instead. - Support "sparse trees"; see
OrgController.sparseQuery
- Render PGP blocks, comment lines, decrypted content
onLinkTap
now returns anOrgLink
object instead of the URL. SeeOrgLink.location
for the URL.
- Clear existing search result keys when performing a query
- Support supplying swipe actions on
OrgSection
s: callers should provide anOrg.onSectionSlide
callback that returns widgets to display in the revealed region - The
hideMarkup
flag is replaced in favor of anOrgSettings
class allowing fine-grained control over each display effect, plus many new options- Use
OrgSettings.hideMarkup
for behavior equivalent to the old flag
- Use
- The
OrgController.of(context).hideMarkup
setter is removed; instead provideOrgSettings
declaratively at the entrypoint - Respect
org-pretty-entities
,org-hide-emphasis-markers
in local variables list - Respect
#+STARTUP
keywords:[no]hideblocks
[no]hidedrawers
hidestars
/showstars
entitiespretty
/entitiesplain
inlineimages
/noinlineimages
[no]fold
/overview
/content
/show[2..5]levels
/showall
/showeverything
- Improve Elisp compatibility, pin engine version to prevent unwanted upgrades
- Prevent spurious Dart tooling crash (#10)
- Improved support for local variables
- Receive information about errors via
OrgController.errorHandler
- Render local variable lists
- Optionally interpret
org-entities-user
(ororg-entities-local
) local variable definitions to customize the entities list; seeOrgController.interpretEmbeddedSettings
- Expose
hideMarkup
option onOrg
andOrgText
widgets
- Remove disused dependency
- Improve code block syntax highlighting (previously based on highlight.js v9.18.1; now v11.8.0)
- Syntax-highlighted source blocks will now participate in text selection
- Tap footnote references to jump between footnote definition and first reference
- Fix Flutter SDK version requirement (3.14 beta has been required since 4.0)
- Editing is now supported; see the example app
- Handle list item taps via the new
onListItemTap
callback OrgThemeData.copyWith
now uses keyword args- Bottom "safe area" padding on
OrgDocumentWidget
can now be disabled - The new
OrgText
widget allows using an Org snippet as a richText
equivalent
- Fix bug in text reshaping
- Upgrade to org_parser 4.0.0
- Require Flutter >=3.13.0, Dart >=3.0.0
- The
loadImage
callback will be called for SVG links - Text is no longer reflowed unless the
hideMarkup
option is enabled
- Require iOS 11.0+
-
Track keys for search result spans, expose via
OrgControllerData
When performing a search with
OrgController.of(context).search
, after the widget build phase is complete you can accessSearchResultKey
s inOrgController.of(context).searchResultKeys
.
- Fix minor API issues
- Require Flutter >=2.14.0, Dart >=2.18
- Fix null dereference when applying search query
- Improve documentation
- Handle
id:
and#custom-id
links - Add methods for resolving section links to
OrgControllerData
sectionWithId
sectionWithCustomId
sectionForTarget
- Relicense under the MIT License
- Support loading images via
loadImage
callback supplied toOrg
orOrgEvents
- Fix nullability issues with headline, src block
OrgTheme.of
,OrgEvents.of
now return non-nullable instances; they will throw if the expected widgets are not present in the supplied context
- Support automatic state restoration
- Manual state management facilities
initialState
andstateListener
onOrgController
have been removed - Instead provide
restorationId
toOrg
orOrgController
- Manual state management facilities
- Migrate to non-nullable by default
- Property lines, planning/clock lines no longer wrap
- Fix handling of drawer content
- Handle planning/clock lines as separate elements
- Take theme brightness from current
ThemeData
, notMediaQuery
- Change effects of
hideMarkup
option:- Drawers and meta lines no longer hidden, but rather faded (reduced opacity)
- Block headers, meta lines truncated to fit document width with no wrapping
- Prettify org entities
- Update flutter_tex_js to v0.1.1 (LaTeX fragments now follow ambient font size)
- Fix extraneous line break following LaTeX block
- Support LaTeX inline and block fragments
- Add
shrinkWrap
option toOrgDocumentWidget
andOrgSectionWidget
- Fix error handling source blocks with no language specification
- Highlight syntax in source blocks
- Fix headline layout with long tags
- Replace
OrgControllerData.initialScrollOffset
withOrgControllerData.scrollController
- Changes to
OrgControllerData
members- E.g.
OrgController.of(context).hideMarkup
is now a setter/getter rather than aValueNotifier
- E.g.
- Add ability to save/restore transient view state (currently section
visibilities, scroll position)
- See
initialState
,stateListener
args toOrgController
constructor
- See
- Add
hideMarkup
argument toOrgController
constructor
- Add example
- Pad root view to safe area
- Inherit visibility state when narrowing
- Various refactoring
- Fix color of inline footnote body
- Fix table width
- Fix block, drawer trailing space when collapsed
- Only break link text by character when the text is (probably) a URL
- Use a ListView as document/section root
- Set document padding in theme: see
OrgThemeData.rootPadding
- Right-align table columns that are primarily numeric
- Initial release