Simon Michael
731cda3f65
;shake: use --dry-run instead of changelogs-dry
2020-09-07 11:41:56 -07:00
Simon Michael
00e12c626c
;shake: simplify argument handling, fix setversion
2020-09-07 11:41:56 -07:00
Simon Michael
306975e6ac
;shake cabalfiles updates .cabal files
2020-09-07 11:41:56 -07:00
Simon Michael
1f4907928c
;shake: build can take package arguments, drop Shake PKG
2020-09-07 11:41:56 -07:00
Simon Michael
a1321b7f26
;shake: commandhelp -> commandtxts, don't build this for "manuals"
2020-09-07 11:41:56 -07:00
Simon Michael
f8a57dae51
;shake: help, cleanups
2020-09-07 09:23:42 -07:00
Simon Michael
5c86e0bdbd
;shake changelogs: do both dev & release updates, based on .version
...
And add changelogs-dry.
2020-09-07 09:23:42 -07:00
Simon Michael
79b532017b
;shake: setversion can operate on specified packages
2020-09-07 09:23:42 -07:00
Simon Michael
fdd346294f
;shake: setversion can save a new version number
2020-09-07 09:23:42 -07:00
Simon Michael
ec2826ba09
;shake: cleanup
2020-09-07 09:23:42 -07:00
Simon Michael
13ccd23304
;shake: bump resolver
2020-09-07 09:23:42 -07:00
Simon Michael
ab9e50003c
shake: refactor; use only the first argument as build target
2020-09-07 09:23:42 -07:00
Simon Michael
a0277a8d43
;shake: docversions no longer used
2020-06-07 12:46:09 -07:00
Simon Michael
d79578cbfa
;shake: try default quiet verbosity
2020-03-18 16:22:37 -07:00
Simon Michael
fe0253eddb
;shake: cleanups
2020-03-18 15:46:43 -07:00
Simon Michael
1e2e83ab7e
shake: use script command, allow running without compiling first
2020-03-18 15:40:56 -07:00
Simon Michael
ccac3d6cfa
;shake: refactor; add _info_ m4 macro
...
[ci skip]
2020-01-29 06:01:09 -08:00
Simon Michael
c84466fb29
;shake: can use the default stack.yaml/GHC 8.8 ( #1090 )
...
[ci skip]
2020-01-28 09:21:10 -08:00
Simon Michael
b9763b9bdd
;stack: simplify stack file names
2020-01-27 06:25:29 -08:00
Simon Michael
444c4342ed
;doc: manuals: hide NAME/SYNOPSIS/DESCRIPTION headings in web manuals
...
[ci skip]
2020-01-25 16:57:51 -08:00
Simon Michael
91978db328
;shake: generate web manuals in package dirs, like the others
...
[ci skip]
2020-01-25 16:26:26 -08:00
Simon Michael
84984499bb
;shake: refactor
2020-01-25 16:17:48 -08:00
Simon Michael
e789cc93f5
;doc: fix yet another rendering issue with new pandoc ({=html})
...
Since pandoc 2.8 the markdown writer adds this raw_attribute syntax by default.
2020-01-06 09:41:03 -08:00
Simon Michael
6dcf6310a3
;doc: strip html comments, preserved by latest pandoc (?)
...
Not sure when the --strip-comments option was added, but we seem
to need it now.
[ci skip]
2020-01-06 07:08:15 -08:00
Simon Michael
714cc18ba8
;Shake setversion: also set man page dates (to current date)
...
[ci skip]
2020-01-05 09:04:50 -08:00
Simon Michael
95f1172c1b
;shake: txt manuals are different, group others together
...
[ci skip]
2020-01-05 07:37:09 -08:00
Simon Michael
412ea86a2d
;shake: use older GHC to work around regex#173 ( #1090 )
...
[ci skip]
2020-01-04 21:17:50 -08:00
Simon Michael
8b3e7ea72b
;Shake: consistency tweak in the webmanuals help
2019-12-09 06:36:45 -08:00
Simon Michael
ccc42d4c2b
;Shake: add "webmanuals" to the default help
2019-12-09 06:35:04 -08:00
Simon Michael
eb1bb0702d
;Shake webmanuals: add a "generated by" comment (hledger_site/#10)
...
[ci skip]
2019-12-09 06:33:08 -08:00
Simon Michael
87d0491103
;bump version to 1.16
2019-12-01 10:03:58 -08:00
Simon Michael
3c226f869a
;stack: use base-compat < 0.11 and latest lts for Shake/regex ( #1090 )
...
[ci skip]
2019-11-29 07:48:03 -08:00
Simon Michael
b475ad039a
;shake: note an issue with atomic building of web manuals
...
[ci skip]
2019-11-10 18:33:50 -08:00
Simon Michael
2bbc9b76e5
;Shake clean/Clean: update, fix dangerous over-cleaning in site/
...
[ci skip]
2019-09-15 17:16:59 -07:00
Simon Michael
4b3103cbb1
;Shake: comment all the website generation stuff, sphinx does it now
...
[ci skip]
2019-09-15 17:16:58 -07:00
Simon Michael
09ff703a9b
;Shake manuals: also regenerate embeddded command help txts
...
[ci skip]
2019-09-13 10:58:41 -07:00
Simon Michael
4db14ef70f
;api: another round of hledger-api purging; fix the build
2019-09-11 14:49:22 -07:00
Simon Michael
68262c59ed
;shake manuals: workaround to avoid ANSI codes in plaintext help
...
This seems to be a groff bug, as of 1.22.3 & 1.22.4. It always calls
grotty with no flags, even with -c, so grotty adds ANSI/SGR escape
codes in the -Tascii output.
Now instead of groff, we call the lower level commands directly,
requiring tbl, eqn, troff, grotty to be in PATH and compatible.
Not ideal.
[ci skip]
2019-09-02 11:05:28 -07:00
Simon Michael
29f7654c3a
bump versions to 1.15
2019-09-01 08:53:06 -07:00
Simon Michael
113f193486
api: drop from Shake scripts
...
[ci skip]
2019-09-01 08:53:06 -07:00
Simon Michael
40200b60a6
;site: also drop 0.27 manual from shake scripts
...
[ci skip]
2019-08-30 08:00:21 -07:00
Simon Michael
f55985eb9b
;site: stop using pandoc's fenced_code_attributes
...
[ci skip]
2019-08-26 18:41:33 -07:00
Simon Michael
fd5dc7bc18
;doc: fix some table rendering in the html manuals
...
[ci skip]
2019-08-26 09:37:03 -07:00
Simon Michael
cccaa2f1b4
;doc: don't generate combined manual any more
...
[ci skip]
2019-08-26 09:37:03 -07:00
Simon Michael
da6718806a
;doc: don't add page TOCs any more, sphinx has it covered
...
[ci skip]
2019-08-26 09:37:03 -07:00
Simon Michael
4a5b4142e1
;site: fix "fix the webhook's pull of site repo"
...
[ci skip]
2019-08-26 09:34:46 -07:00
Simon Michael
9debf0c288
;site: fix the webhook's pull of site repo
...
[ci skip]
2019-08-26 09:28:52 -07:00
Simon Michael
cea86260c9
;site: pull both repos when either one posts the webhook
...
[ci skip]
2019-08-25 06:26:17 -07:00
Simon Michael
b9b420290c
;site: fix generation of cookbook pages
...
[ci skip]
2019-08-25 06:20:14 -07:00
Simon Michael
ece3d67ebf
site: drop references to the github wiki
...
[ci skip]
2019-08-24 04:34:17 -07:00
Simon Michael
cc9d7f8ae0
Shake changelogs: ignore commits beginning with ;
2019-08-19 11:44:00 +01:00
Simon Michael
11208222d4
shake: be more verbose when updating changelogs
...
[ci skip]
2019-07-25 08:48:01 +01:00
Caleb Maclennan
11d9e5eb6a
code: Strip extraneous trailing whitespace from Haskell sources
2019-07-15 16:40:49 +01:00
Simon Michael
297a831387
;site: symlink the main README.md, render it as part of the site
...
The top-level README.md is usually seen when browsing github or the
cloned source - not on the website - but now we render it as part of
the website to facilitate previewing it locally (with make
site-watch).
As a side effect of symlinking it into site/, it might override site/'s
README when browsing that directory on github.
[ci skip]
2019-05-29 22:33:25 -07:00
Simon Michael
a7ffa6108b
;site: download: reorganise with binaries at top, cleanup, add TOC
...
[ci skip]
2019-05-17 20:59:44 -07:00
Simon Michael
a8599d991e
shake: show htmlmanuals target in help
...
[ci skip]
2019-05-09 12:23:11 -07:00
Simon Michael
688bdf86ec
site: symlink CONTRIBUTING.md instead of copying, less confusing
...
[ci skip]
2019-04-25 08:10:06 -07:00
Simon Michael
93a7dc3461
site: don't render /README.md as part of site, not used & confusing
...
[ci skip]
2019-04-25 08:05:57 -07:00
Simon Michael
e8eee8e7c7
; shake comment
2019-03-21 10:23:41 -07:00
Simon Michael
a34892f358
;shake hledgerorg: tweak home page commit message
2019-03-08 19:59:45 -08:00
Simon Michael
7b94b0c9b2
make site: log to site.log again
...
[ci skip]
2019-03-06 09:30:54 -08:00
Simon Michael
e5f3dd1a75
shake site: also commit & push home page when wiki links change
...
[ci skip]
2019-03-06 09:30:54 -08:00
Simon Michael
7af5ee4863
tools: move site.sh into shake; stop running just-pushed shakefile
...
Running the just pushed Shake.hs was too insecure.
[ci skip]
2019-03-06 09:30:54 -08:00
Simon Michael
9333cfe28b
shake: don't echo commands by default
...
[ci skip]
2019-03-06 08:48:48 -08:00
Simon Michael
247cb4e1ad
shake: clean up docs
2019-03-05 19:21:45 -08:00
Simon Michael
f9aa71caf1
shake commandhelp: don't generate a txt for the README ( #981 )
...
[ci skip]
2019-03-04 11:38:11 -08:00
Simon Michael
0984a8cd41
shake: add 1.14 to web manual versions
...
[ci skip]
2019-03-01 18:17:35 -08:00
Simon Michael
ff7395bb32
Shake clean: don't remove version-controlled command help files
...
[ci skip]
2019-02-26 10:14:29 -08:00
Simon Michael
2364a53f49
site: add table of contents to all wiki pages with 2+ headings
...
[ci skip]
2019-02-11 14:12:48 -08:00
Simon Michael
3aad6696c9
shake: fix old manuals' deps; don't build them by default; refactor
...
[ci skip]
2019-02-11 13:07:06 -08:00
Simon Michael
d0996213cd
site: wiki pages: get links from Home; prepend page name headings
...
[ci skip]
2019-02-09 19:28:53 -08:00
Simon Michael
aeb7d58c31
shake: cleanup
2019-02-09 19:28:53 -08:00
Simon Michael
d79bd77feb
site: wiki integration - render wiki pages within main site
...
The github wiki pages are now rendered as part of the website's static
content, like the main site pages (and using the same pandoc markdown).
Building the site now requires that a copy of the wiki is checked out
under wiki/.
Github wiki links are converted to suitable relative links,
in all pages (not just wiki pages).
`make site/index.md-push`, which updated the wiki links on the website
home page and committed/pushed it, is now `./Shake site/index.md`, and
doesn't commit/push.
Shake.hs now also depends on the `regex` package.
[ci skip]
2019-02-09 19:28:53 -08:00
Simon Michael
ce2ef2497a
shake: also generate static html from wiki pages
...
A copy of the github wiki is assumed to be checked out in ./wiki/
[ci skip]
2019-02-09 19:28:53 -08:00
Simon Michael
de69456b8f
shake: fix the fix
...
[ci skip]
2019-02-05 11:56:51 -08:00
Simon Michael
2bd0d27976
shake: be GNU sed compatible, fixing defs.m4 updating
...
[ci skip]
2019-02-05 11:55:52 -08:00
Simon Michael
f4e237afd6
shake [PKG/]CHANGES.md-finalise : sets final changelog heading
...
Replaces an interim (commit hash) heading with a release heading based
on the .version file and today's date.
[ci skip]
2019-02-05 07:31:06 -08:00
Simon Michael
18ffa65168
tools: move setversion to shake, use PKG/.version, set upper bounds
...
./Shake setversion will now propagate the version number in each
package's .version file, to all the places in that package where it's
needed (ie the defs.m4 file and multiple places in the package.yaml
file. Also it now updates upper bounds on other hledger packages
to the next major version. (The new lower/upper bounds may not always
be what's desired, manual review required.)
[ci skip]
2019-02-04 18:47:27 -08:00
Simon Michael
bf6acf52ef
doc: allow per-package m4 defs, to override things like version
...
[ci skip]
2019-02-04 15:18:51 -08:00
Simon Michael
3f4473639a
doc: lib.m4 -> common.m4; restore required _FLAGS_ macro
...
[ci skip]
2019-02-04 14:44:35 -08:00
Simon Michael
384c555f99
make, shake: refer to each other's help
...
[ci skip]
2019-02-03 17:01:57 -08:00
Simon Michael
40d1572359
bump version to 1.13
2019-02-01 17:19:19 -08:00
Simon Michael
f1d4b39146
shake: update help, clean/Clean output
...
[ci skip]
2019-02-01 10:38:14 -08:00
Simon Michael
89bb4816c6
shake: move changelog scripts to Shake, enhance
...
New shake targets:
./Shake changelogs
./Shake CHANGES.md
./Shake CHANGES.md-dry
./Shake PKG/CHANGES.md
./Shake PKG/CHANGES.md-dry
Enhancements:
- removes the changelog's previous top heading
- ignores commits like "changelog", "doc: update changelogs"..
- does not write temporary files
- dry run mode
[ci skip]
2019-02-01 10:36:49 -08:00
Simon Michael
5435150d39
doc: don't use sed; fix accidental dedenting of some lists ( #961 )
...
The sed code was showing an error message, not too precise.
Pandoc's lua filters to the rescue!
[ci skip]
2019-01-31 08:34:49 -08:00
Simon Michael
c8246e7323
cli: command help: reduce width, line wrapping
...
cmdargs wraps any lines longer than 78 characters. To (mostly) avoid
this, we now display verbatim blocks unindented, and some of
register's examples have been altered to make them fit.
2019-01-30 17:58:13 -08:00
Simon Michael
fa996828b1
shake: fix build's doc deps; cleanup
...
[ci skip]
2019-01-30 12:45:09 -08:00
Simon Michael
4c5ac4dd06
cli: fix command help, really render as plain text
...
pandoc thinks .txt is a markdown file apparently
2019-01-30 12:44:10 -08:00
Simon Michael
0628b648f3
shake: Shake PKG (or Shake build) builds packages plus their docs
...
"stack build hledger" will not notice changes in documentation source
files (like hledger/Hledger/Cli/Commands/Add.md or
hledger-lib/hledger_journal.m4.md), but "./Shake hledger" will.
"./Shake build" builds all the packages, like a doc-aware "stack build".
2019-01-30 10:41:39 -08:00
Simon Michael
5b6c441698
shake: manuals: also depend on new command doc files
2019-01-26 16:33:35 -08:00
Simon Michael
789e8be280
shake: update required tools list
...
[ci skip]
2019-01-25 07:04:16 -08:00
Simon Michael
eac15369f2
doc: stop pandoc typography conversions in html manuals ( #954 )
...
Eg: -- was being rendered as en-dash.
[ci skip]
2019-01-24 15:29:56 -08:00
Simon Michael
5c5e404df6
doc: contributing: add TOC
2019-01-19 17:31:03 -08:00
Simon Michael
d095e6a06b
shake: also clean the copied README/CONTRIBUTING
...
[ci skip]
2019-01-19 15:47:39 -08:00
Simon Michael
5000c6ac6a
site: forcing lower-case URIs is a hassle; add redirects for now
...
[ci skip]
2019-01-19 15:42:43 -08:00
Simon Michael
240406706a
move the wiki dev docs into CONTRIBUTING.md. Markdown for now. #920
...
[ci skip]
2019-01-19 15:31:21 -08:00
Simon Michael
9f057731c3
shake: common pandoc opts
...
[ci skip]
2019-01-19 15:31:21 -08:00
Simon Michael
b7e64440b2
shake: cleanups, document
...
[ci skip]
2019-01-19 15:31:21 -08:00
Simon Michael
1077ccf70c
shake: cleanups
...
[ci skip]
2019-01-19 15:31:21 -08:00
Simon Michael
ef0f4cd4d2
shake: disable pandoc's tex math extension to silence relnote warning
...
[ci skip]
2018-12-03 09:21:05 -08:00
Simon Michael
67d7c82e9f
bump version to 1.12
2018-12-02 17:20:34 -08:00
Simon Michael
e6556e4760
site: shake: also generate the 1.11 web manual
...
[ci skip]
2018-10-06 09:48:03 -10:00
Simon Michael
7f1b34ea1d
doc: fix generation of 1.10 manual html
2018-07-04 13:22:09 +01:00
Everett Hildenbrandt
615ca04813
Shake.hs: use system-wide install of pandoc instead of stack exec pandoc
2018-05-21 08:35:49 -07:00
Everett Hildenbrandt
16200908e8
Shake, tools/pandoc-site.{hs => lua}: switch to building site with Lua filter
2018-05-21 08:35:49 -07:00
Everett Hildenbrandt
946fa1d498
tools/pandoc-{site,drop-toc}, Shake, site/, doc/: switch from bulletlist to metainline toc marker
...
Files `site/doc/{1.0,1.1}/hledger-ui.md` had to be treated specially because
thay had some other elements inside the same `BulletList` that the `toc` lived
inside. Because only the first element of the `BulletList` is compared, these
extra HTML elements were either dropped or replaced with a TOC at compile time.
By switching to the meta-inline `\$toc\$`, they started to persist into the
resulting HTML. The fix was to drop them from the source markdown.
2018-05-21 08:35:49 -07:00
Everett Hildenbrandt
e8ac237752
Shake.hs, stack-ghc8.2.yaml: missing extra-dep for pandoc
2018-05-21 08:35:49 -07:00
Simon Michael
fe7157dfa4
tools: remove some more hakyll-std traces
...
[ci skip]
2018-05-09 10:20:21 -07:00
Everett Hildenbrandt
2618455ab9
Shake.hs: organize
2018-05-09 10:13:02 -07:00
Everett Hildenbrandt
1a909fe2a3
Shake.hs, site/hakyll-std: remove mentions/dependencies of hakyll-std
2018-05-09 10:13:02 -07:00
Everett Hildenbrandt
567a86b810
Shake.hs, site/site.tmpl: build website completely with pandoc, no hakyll-std
2018-05-09 10:13:02 -07:00
Everett Hildenbrandt
bac12543df
tools/pandoc-site.hs, Shake.hs: pandoc filter version of hakyll-std website builder
2018-05-09 10:13:02 -07:00
Everett Hildenbrandt
0669111c71
Shake.hs, hakyll-std: build static parts of site directly with Shake target website-copy
2018-05-09 10:13:02 -07:00
Simon Michael
de56ee0b93
tools: use default resolver for Shake and hakyll-std again
2018-04-25 19:01:38 -07:00
Simon Michael
541e517221
tools: fix build hang in Shake
...
[ci skip]
2018-04-25 17:41:28 -07:00
Everett Hildenbrandt
39b20ffb3f
Shake.hs: remove targets/comments about old pandoc filters
2018-04-25 17:25:09 -07:00
Everett Hildenbrandt
ddaea7cffc
Shake.hs, tools/pandoc-drop-toc: switch to lua script filter
2018-04-25 17:25:09 -07:00
Everett Hildenbrandt
95c9af5664
Shake.hs, tools/pandoc-drop-notes: remove unused filter
2018-04-25 17:25:09 -07:00
Everett Hildenbrandt
fbc9c63c62
Shake.hs, tools/pandoc-drop-notes: switch to lua script filter
2018-04-25 17:25:09 -07:00
Everett Hildenbrandt
364d3dc756
Shake.hs, tools/pandoc-drop-links: switch to lua script filter
2018-04-25 17:25:09 -07:00
Everett Hildenbrandt
79e46bb0fb
Shake.hs, tools/pandoc-drop-html-inlines: switch to lua script filter
2018-04-25 17:25:09 -07:00
Everett Hildenbrandt
b83240ab6d
Shake.hs, tools/pandoc-drop-html-blocks: switch to lua script filter
2018-04-25 17:25:09 -07:00
Everett Hildenbrandt
33e08a7d86
Shake.hs, tools/pandoc-demote-headers: switch to lua script filter
2018-04-25 17:25:09 -07:00
Simon Michael
8ce5c84f35
tools: misc Shake, pandoc filter fixes
2018-03-31 02:43:28 +01:00
Simon Michael
7ffdcc509d
doc: move most non-manual docs to the wiki
2018-03-07 23:48:08 -08:00
Simon Michael
9ab8c5c4da
shake: don't generate pandoc fenced divs when transforming markdown ( #692 , #696 )
...
[ci skip]
2018-01-24 18:35:19 -08:00
Simon Michael
ea1ddd86b3
shake: build with nightly resolver, remove pandoc workarounds
...
stackage nightly now has pandoc 2.0.5 which builds with GHC 8.2.
https://github.com/jgm/pandoc/issues/4130
2017-12-14 18:17:43 -08:00
Simon Michael
a078936c86
shake: "guidepages" also needs to build pandoc filters
2017-12-08 15:38:13 -08:00
Simon Michael
344fced409
shake: use GHC 8.0 again to avoid 8.2/pandoc error
...
https://github.com/jgm/pandoc/issues/4130
2017-12-08 02:52:09 -08:00
Simon Michael
316b6f344e
shake: build only the needed, pandoc-2-compatible pandoc filters
2017-12-07 12:02:13 -08:00
Simon Michael
c082f2676b
shake: switch to default resolver (nightly) & pandoc 2
2017-12-07 12:01:36 -08:00
Simon Michael
0f2b95041e
doc: fix breakage in text manuals
2017-12-06 20:53:36 -08:00
Simon Michael
b425e50ad1
change paths in code, scripts, readme
2017-12-06 18:16:35 -08:00
Simon Michael
18d7c4b02c
doc: rename Cookbook to Guide
...
Might need to be more specific or rename the developer/contributor guide
later. For users, for now, it's Introduction, Guide and Reference.
Still TBD where the basic getting started tutorial lives.
[ci skip]
2017-10-31 13:04:00 -07:00
Simon Michael
a3fa09b604
doc: rename/flesh out "argument files" doc, add to cookbook
2017-10-31 12:37:13 -07:00
Simon Michael
4104334eff
tools: shake: requires GHC 8.0/lts-9 for now
...
[ci skip]
2017-09-08 10:47:35 -07:00
Simon Michael
f4e1d5aaec
tools: shake: docs -> manuals
2017-07-31 15:53:34 -07:00
Christian G. Warden
659b9c9d32
Use pandoc From Stackage Snapshot ( #558 )
...
Use pandoc from stackage snapshot when building documentation to ensure
that pandoc and the pandoc filters are built against the same version of
pandoc-types; otherwise, the filters can fail with an obtuse error (see
https://github.com/jgm/pandoc/issues/3217 ).
2017-05-30 07:26:24 -07:00
Simon Michael
f7c7b70a70
tools: shake: note a warnings issue
2017-03-27 05:09:42 -07:00
Simon Michael
cdece768ae
tools: shake: fix cleaning of pandoc filters
2017-03-27 04:39:00 -07:00
Simon Michael
39e0601446
tools: shake: don't remove old manuals when cleaning
2017-03-27 04:38:17 -07:00
Simon Michael
046b443da5
doc: cookbook: prices example
2017-02-02 11:46:25 -08:00
Simon Michael
761d912324
doc: docs page, cookbook tweaks
2017-02-01 16:24:37 -08:00
Simon Michael
7c5b97816e
doc: cookbook: journal starting and version control recipes
2017-01-26 14:19:59 -08:00
Simon Michael
d4654d46af
doc: cookbook tweaks, simpler titles
...
Also drop the main heading from the big manual again,
it disrupted the TOC style.
[ci skip]
2017-01-26 09:51:14 -08:00
Simon Michael
4d91013182
doc: add main heading to combined manual & cookbook
...
[ci skip]
2017-01-26 09:51:08 -08:00
Simon Michael
2afc955f45
doc: cookbook: fix combined order
...
[ci skip]
2017-01-26 09:22:57 -08:00
Simon Michael
98d8909bfa
site: cookbook: start collecting journal entries
...
[ci skip]
2017-01-26 09:15:03 -08:00
Simon Michael
e7d459a368
site: begin organising a cookbook
2017-01-26 06:40:50 -08:00
Simon Michael
e881a29b0e
tools: move pandoc filters out of docs/
...
[ci skip]
2017-01-10 08:49:05 -08:00