Releases: gtg922r/obsidian-numerals
1.5.1
1.5.0
🚀 Numerals 1.5 - Biggest Update Yet! 🚀
Introducing some of the most requested features including the ability to:
- sum previous lines with
@sum
or@total
- reference note frontmatter properties
- use global variables between blocks
- insert calculation results directly into your notes
Also new convenience features such as Greek letter auto-completion and custom currency support. Upgrade now and take your note-taking calculations to the next level!
Detailed Updates
⭐️ Sums and Totals of Previous Lines
- New feature and syntax for summing a group of lines:
@sum
or@total
(closes #18, #49, #36) - When Numerals encounters
@total
or@sum
it inserts the sum of all previous lines up until the last blank line or comment - Can use in a calculation or unit conversion
⭐️ Values in Note Frontmatter
Numerals can now reference note frontmatter or dataview inline values. Set the numerals
property on a page to share specific properties with all math blocks on a page.
In order to access metadata, you need to tell Numerals to make the value available by:
- Set the
numerals
metadata value (either frontmatter or dataview inline property) to the name of the value you want to include, or a list of values- Frontmatter of
numerals: other_metadata_name
, ornumerals: [metadata_1, metadata_2]
- inline value:
[numerals:: other_metadata_name]
- Frontmatter of
- Set the metadata value of
numerals
toall
: will index all metadata and make it available to dataview - Enable "Always Process All Frontmatter" in the Numerals settings
Numerals is able to write back to dataview values, through use of Result Insertion
⭐️ Note-wide Global Variables
Any variable name preceeded by an $
symbol will be made available to all math blocks on a page (closes #34)
⭐️ Result Insertion - Store Results in Raw Text
Using the new @[...]
syntax (for example: @[profit]
), Numerals will insert the results of a calculation into the raw text of your notes. (closes #22)
⭐️ Greek Letter Auto-complete
- Add greek letter auto-completion after typing
:
. e.g.:mu
in a math block will offerμ
as an auto-complete suggestion (closes #69) - Greek letters can be used in any variable name. They also work with subscripting when in
math-tex
block.
⭐️ Custom Currency Support
1.4.1
🧪 Beta Release 1.4.1 🧪 (Bug fix only)
- Fixes bug with result insertion. Result insertion can now be used on the same line as initial assignment to a variable:
a = 1
b = 2
@[result] = a + b
Once rendered, will become:
a = 1
b = 2
@[result::3] = a + b
1.4.0
🧪 Beta Release 1.4 🧪
Support for frequently requested features!
- "Sum" (or "Total") feature
- Page "Globals" (i.e. shared variables)
- Result Insertion: Calculation result added to note source using dataview syntax
🚧 Note to Beta Testers: Supporting sums/totals requires some additional pre-processing by Numerals. "Globals" is dependent on when blocks get rendered. Please report any bugs you see as I may have missed some corner cases! 🚧
Numerals 1.4 (Beta) includes support for one of the most commonly requested features: The ability to quickly sum previous lines. Numerals now offers a magic variable @sum
or @total
, which will always be populated with the sum of all previous lines up to a blank line or header/comment. As a magic variable it can be used in equations, conversions, or assignment to other variables.
Numerals 1.4 (Beta) includes support for "globals" - variable values that keep their value across code blocks. This should be considered experimental - please report any issues! In a code block, create a new variable prefixed with a $
. That variable will be available in later math
codeblocks.
Warning: Numerals can't ensure a consistent ordering of math block evaluation. If you assigned a value to a global in multiple code blocks you may get unexpected results. Its best to only assign the value in one place.
Numerals 1.4 (Beta) has 🚨 experimental 🚨 support for "result insertion". Wrapping a variable name in @[...]
(e.g. @[result]
), will tell Numerals to insert the value of the variable into the source of the note itself using dataview notation (e.g. variable::value
). This allows you to ensure calculation results are saved to the source of the note (in case you ever use outside of Obsidian), as well as setting dataview values using Numerals.
Numerals 1.4 (Beta) also adds a convenience feature for autocomplete of greek characters, by typing :
in a math
block and then starting to type the name of the character. Greek characters are fully supported by Numerals' math engine, so you can name your variables using math characters. This includes in -tex
mode, where subscript support is also included, and ω_n
will render as
Note: this feature can be disabled in settings if it conflicts with any autocomplete tools you already have
1.3.1
1.3.0
🧪 Beta Release 1.3
- Access frontmatter or dataview inline variables inside code blocks
- Math code block auto-update after metadata or settings change
- Render subscripts in TeX mode
1.2.1
Beta release
- Switch font colors to be based on
--code-
variants. Should allow for better consistency with themes - Please open an issue if this negatively affects any styling
1.2.0
🎉 Numerals 1.2
- Adds auto-completion to all variables with an option to auto-complete on all functions and constants!
- Adds user setting to specify rendered number formatting
- Fixes bugs with comma decimal separators: #19, #23, #28
- Fixes a bug causing issues on iOS
Auto-completion Suggestions
By default, Numerals will provide auto-completion suggestions for variables that have been defined in a particular math
codeblock. Turning on Include Functions and Constants in Suggestions will also provide suggestions for all functions, math constants, and physical constants supported in Numerals.
Formatting Options
- System Formatted: Use your local system settings for number formatting
- Fixed: No thousands separator and full precision
- Exponential: Always use exponential notation.
- Engineering: Exponential notation with exponent a multiple of 3.
-
Formatted: Forces a specific type of formatted notation.
- Formatted: 100,000.1
- Formatted: 100.000,1
- Formatted: 100 000,1
- Formatted: 1,00,000.1
- Note:
math-tex
mode will always use period as decimal separator, regardless of locale.
1.0.10
Release Changes
- Adds user setting to specify rendered number formatting
- Fixes bugs with comma decimal separators: #19, #23, #28
Formatting Options
- System Formatted: Use your local system settings for number formatting
- Fixed: No thousands separator and full precision
- Exponential: Always use exponential notation.
- Engineering: Exponential notation with exponent a multiple of 3.
-
Formatted: Forces a specific type of formatted notation.
- Formatted: 100,000.1
- Formatted: 100.000,1
- Formatted: 100 000,1
- Formatted: 1,00,000.1
Note: math-tex mode will always use period as decimal separator, regardless of locale.
1.0.9
Rewrite result annotation regex which was crashing Numerals on iOS