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)
(-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 ```
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]].
(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`
cljdoc builds & hosts documentation for Clojure/Script libraries
Ctrl+k | Jump to recent docs |
← | Move to previous article |
→ | Move to next article |
Ctrl+/ | Jump to the search field |