Preview Feature

[kkharji]

Generic

---

• [x] Generate and open pdf/html files
• [x] Change from one kind to another depending on last kind used to open the previewer
• [x] Support conditional loading of preview module features.
• [x] Auto-generate (aggressive) on any overall changes in the buffer
• [x] Support opening/update previewer on BufEnter, if auto-preview is enabled..
• [x] Support setting a latex template for PDF.
• [ ] Parse fontmatter variables (YAML) and pass it to cfg.preview.pdf.template function
• [ ] Support modifying HTML css.
• [ ] Support modifying generate filenames. support versioning?
• [ ] auto-clean files on exit when the path start with /tmp

Chores

• [x] Add documentation for preview module configuration function by creating new function that point to those functions
• [ ] generate docs

Issues

---

• [x] Skip generating if current file doesn't or no longer exist.
• [ ] On generation errors, don't log error, open Quick-fix instead.

HTML

---

• [ ] provide user a function to set HTML css.

Someday

---

• [ ] Auto-scroll html pages depending on current line in the buffer.
• [ ] Auto-refresh html page when regenerating html.
• [ ] Update previwer on switching to antoher markdown buffer.
• [ ] Close previewer on nvim exit.
• [ ] Cover other Filetypes then *.md, better yet, load them from a cfg value

[kkharji]

Auto-scroll and auto-refresh might require an actual server. Thus, I'd need to implement a markdown preview server in lua

[kkharji]

Preview files generated in tmp path should be auto-cleaned. Maybe keep track of generated files in preview module, then on exist iter over them if they start with tmp and unlink them.

[kkharji]

It would be great if we can define a set of function that returns template configuration. Then use them by defining a template variable in yaml that get used to call those function.

For example, user defines

mdenv.preview.pdf.templates = {
   company_X = function()
      return {
         path = "path/to/template",
         vars = {} -- extra vars
         extra_args = {} -- extra args to pass to the generator 
      }
   end
}

[kkharji]

Use fontmatter to pass extra args to the generator? maybe under a key?

Some variables I'd like to support

mdenv:
   toc: true
   listings: true