Skip to content

Releases: ErpNetDocs/docfx

v.2.56.9

26 Apr 11:53
Compare
Choose a tag to compare

v.2.56.9

  1. Fix a bug where dot (.) wouldn't be considered for the current folder

v.2.56.10

28 Apr 14:49
Compare
Choose a tag to compare

v.2.56.10

General fixes in [!list] operator

  1. Getting title for a link to an article when there is no title in
    frontmatter, neither in the document, will result in the path to the article
    itself
  2. Strip title in above case when title is retrieved from markdown header

v.2.56.8

08 Apr 13:06
Compare
Choose a tag to compare

Version Notes (Current Version: v2.56.8)

v.2.56.8

  1. Fix a bug where dot (.) wouldn't be considered as identifier in [!list] parsing

v.2.56.7

31 Mar 12:11
Compare
Choose a tag to compare

Version Notes (Current Version: v2.56.7)

v.2.56.7

  1. Fix parsing for [!list] - more attributes are parsed correctly without quotation

  2. Fix depth for [!list]

  3. Fix pattern matching for [!list]

    • Each file has canonical name in the form of ~/home/pics/profile.png. This will be used for examples below.
    • If folder pattern is *, then each candiate must be child of ~/home/pics (or a sub-directory)
    • If folder pattern starts with / or ~/ - e.g. /var/logs - each child must be child of /var/logs (or a sub-directory)
    • Folder pattern can be any file glob pattern (e.g. * for each character, ? to mean any single character)
    • If folder pattern is neither *, nor it starts with /, nor '~/', then ~/home/pics/ is prepended, then the
      folder for the examined file (e.g. ~/home/batman.txt -> ~/home) is examined
    • After that, exclude pattern is examined. The folder name of the examined file is compare to any file's folder name.
      If there is a match, the file is excluded (e.g. for file /home/pics/through-hike/awesome.png and pattern
      *hike, the file will be excluded, because through-hike matches hike)
    • Next, depth is examined. If files are related, e.g. they are either in the same directory, or one is in a sub-directory
      of another, then depth is calculated. For both ~/home/pic.png and ~/home/pics/profile and
      ~/home/pics/profile and ~/home/pic.png, depth is 1. If files are in the same folder, depth is 0. Files that are not
      related are discared from the result.
    • File pattern gets the file name of the currently examined file and matches is to the file file glob pattern.
  4. Ordered lists are rendered correctly - with n., rather than just n, where n is the consequtive number

  5. There is an additional ... item in the final rendered list if some items are skipped due to limit

v.2.56.6

09 Mar 09:12
Compare
Choose a tag to compare

Version Notes (Current Version: v2.56.6)

v.2.56.6

  1. Fix a bug with default values for [!list]. folder="" and depth=-1 allow for the operator
    to work with conditions as expected

v.2.56.4

22 Jan 13:05
Compare
Choose a tag to compare

v.2.56.4

  1. Implement additional functionality for [!list] operator

    • [!list folder="pattern"] - checks if folder mathes file pattern (*, ?). Pattern must be full path (starting with ~),
      or '.', which assumes current directory of the file being processed. Case sensitive
    • [!list file="sales*"] - checks if file name matches pattern (*, ?). Case sensitive. File name, not full path, is matched.
    • [!list depth=xx] - checks each model if it is up to 2 subdirectories of this file's directory
    • [!list limit=xx] - limits result up to xx items
    • [!list style=xx] - either bullets, numbered lists, or header tags
    • [!list exclude="pattern"] - checks file name if it matches pattern (*, ?). Pattern is case-sensitive. If the pattern
      is matched, the file is excluded. File name, not full path, is matched.
    • Default values:
      • folder="."
      • depth=2
      • file="*"
      • limit=10
      • style=bullets
      • exclude='' - no matter the pattern, list always excludes the currently matches file

v2.56.3.3

11 Nov 11:47
Compare
Choose a tag to compare

v2.56.3.3

  1. Enable Grid Tables

v2.56.3.2

10 Nov 14:59
Compare
Choose a tag to compare

v2.56.3.2

  1. Fix bug where [!list] operator would work as OR instead of AND. This will slightly slow down compilation
    for pages that use this tag.

v2.56.3.1

27 Oct 09:45
Compare
Choose a tag to compare

v2.56.3.1

Sort items by title in [!list] operator
[!list] operator now generates Mardkdown before BuildConceptualDocument, so that it never has to resolve links itself. Also, BuildConceptualDocument can do all the link processing it needs in order to keep things consistent.

v2.56.3

Implement [!list] operator.

If you have file1.md with the following front matter:

---
variable1: value1
variable2: value2
variable3: value3
---

and file2.md with the following front matter

---
variable1: value1
variable3: value3
---

then the following syntax [!list variable1=value1 variable3=value3] will produce the following html:

<ul class="erp-list">
    <li class="erp-list-item"><a href="/absolute/path/to/file1.html">Title Grabbed From file1.md</a></li>
    <li class="erp-list-item"><a href="/absolute/path/to/file2.html">Title Grabbed From file2.md</a></li>
</ul>

Both the variable name and the variable value can be quoted with double-quotation marks (")

Implement shortcut syntax for inclusion.
    Create folder called include in the project root
    Add Conceptual documents there
    In any conceptual document you can @@name-of-file-inside-include-dir-without-extension, and the rendered contents of the file will be included in your markup

This works both for inlines and blocks.

v2.56.2.0-erpbg

14 Sep 14:22
Compare
Choose a tag to compare

Introduce new shortcut for include syntax:

some markdown @@identifier1 some other text

some other text lorem ipsum

@@identifier2

Given the markdown above, the first paragraph will look for ~/includes/identifier1.md and include it inline. In the third paragraph, the contents of ~/includes/identifier2.md will be placed as block element.