Liking cljdoc? Tell your friends :D

chlog.core

Changelog aggregation, specification, validation, and webpage generation.

Options map key-vals:

  • :project-formatted-filename
  • :copyright-holder
  • :changelog-UUID
  • :changelog-html-directory
  • :changelog-html-filename
  • :changelog-markdown-directory
  • :changelog-markdown-filename
  • :changelog-entries-directory
  • :changelog-policies-section (optional)
Changelog aggregation, specification, validation, and webpage generation.

Options map key-vals:

* `:project-formatted-filename`
* `:copyright-holder`
* `:changelog-UUID`
* `:changelog-html-directory`
* `:changelog-html-filename`
* `:changelog-markdown-directory`
* `:changelog-markdown-filename`
* `:changelog-entries-directory`
* `:changelog-policies-section` (optional)
raw docstring

-mainclj

(-main & options-filename)

Generate an html and a markdown changelog, sourcing options from file options-filename if supplied, otherwise resources/chlog_options.edn.

Examples:

;; generate changelog using options from 'resources/chlog_options.edn'
(-main)

;; generate changelog using options from 'other_directory/custom_changelog_opt.edn'
(-main "other_directory/custom_changelog_opt.edn")

From the command line, options file defaults to resources/chlog_options.edn:

$ lein run -m chlog.core

From the command line, explicit options file other_directory/custom_changelog_opt.edn:

$ lein run -m chlog.core other_directory/custom_changelog_opt.edn
Generate an html and a markdown changelog, sourcing options from file
`options-filename` if supplied, otherwise `resources/chlog_options.edn`.

Examples:
```clojure
;; generate changelog using options from 'resources/chlog_options.edn'
(-main)

;; generate changelog using options from 'other_directory/custom_changelog_opt.edn'
(-main "other_directory/custom_changelog_opt.edn")
```

From the command line, options file defaults to `resources/chlog_options.edn`:
```bash
$ lein run -m chlog.core
```

From the command line, explicit options file `other_directory/custom_changelog_opt.edn`:
```bash
$ lein run -m chlog.core other_directory/custom_changelog_opt.edn
```
raw docstring

chlog-defaultsclj

A hash-map residing in chlog_defaults.clj that supplies the default values for the following options keys:

  • :changelog-html-directory
  • :changelog-html-filename
  • :changelog-markdown-directory
  • :changelog-markdown-filename
  • :changelog-entries-directory
  • :changelog-data-file
  • :changelog-policies-section
  • :tidy-html?

Override default values by associating new values into the Chlog options hash-map. See generate-all-changelogs.

A hash-map residing in `chlog_defaults.clj` that supplies the default values
for the following options keys:

* `:changelog-html-directory`
* `:changelog-html-filename`
* `:changelog-markdown-directory`
* `:changelog-markdown-filename`
* `:changelog-entries-directory`
* `:changelog-data-file`
* `:changelog-policies-section`
* `:tidy-html?`

Override default values by associating new values into the Chlog _options_
hash-map. See [[generate-all-changelogs]].
raw docstring

generate-all-changelogsclj

(generate-all-changelogs opt)

Given Chlog options opt, write-to-file html and markdown changeloges.

See project documentation for details on the structure of the options map.

Changelog data will be read from resources/changelog_entries/changelog.edn unless superseded by :changelog-entries-directory or :changelog-data-file values in the options map.

Defaults supplied by src/chlog_defaults.edn

Given Chlog options `opt`, write-to-file html and markdown changeloges.

See project documentation for details on the structure of the options map.

Changelog data will be read from `resources/changelog_entries/changelog.edn`
unless superseded by `:changelog-entries-directory` or
`:changelog-data-file` values in the options map.

Defaults supplied by `src/chlog_defaults.edn`
raw docstring

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts
Ctrl+kJump to recent docs
Move to previous article
Move to next article
Ctrl+/Jump to the search field
× close