Commit graph

229 commits

Author SHA1 Message Date
Chris Morgan 1a9ab968fe Allow manual specification of header IDs (#685)
Justification for this feature is added in the docs.

Precedent for the precise syntax: Hugo.

Hugo puts this syntax behind a preference named headerIds, and automatic
header ID generation behind a preference named autoHeaderIds, with both
enabled by default. I have not implemented a switch to disable this.

My suggestion for a workaround for the improbable case of desiring a
literal “{#…}” at the end of a header is to replace `}` with `}`.

The algorithm I have used is not identical to [that
which Hugo uses][0], because Hugo’s looks to work at the source level,
whereas here we work at the pulldown-cmark event level, which is
generally more sane, but potentially limiting for extremely esoteric
IDs.

Practical differences in implementation from Hugo (based purely on
reading [blackfriday’s implementation][0], not actually trying it):

- I believe Hugo would treat `# Foo {#*bar*}` as a heading with text
  “Foo” and ID `*bar*`, since it is working at the source level; whereas
  this code turns it into a heading with HTML `Foo {#<em>bar</em>}`, as
  it works at the pulldown-cmark event level and doesn’t go out of its
  way to make that work (I’m not familiar with pulldown-cmark, but I get
  the impression that you could make it work Hugo’s way on this point).
  The difference should be negligible: only *very* esoteric hashes would
  include magic Markdown characters.

- Hugo will automatically generate an ID for `{#}`, whereas what I’ve
  coded here will yield a blank ID instead (which feels more correct to
  me—`None` versus `Some("")`, and all that).

In practice the results should be identical.

Fixes #433.

[0]: a477dd1646/block.go (L218-L234)
2019-05-20 13:08:49 -07:00
Vincent Prouillet 290029aeed Fix a bit the pagination template doc 2019-05-18 17:55:10 -07:00
Vincent Prouillet e21a102f89
Merge branch 'master' into next 2019-05-15 21:42:51 -07:00
Vincent Prouillet a1a40574f6 Build syntax dumps 2019-05-14 08:52:12 -07:00
Vincent Prouillet 7337b38b96 Netlify support is back! 2019-05-09 09:23:17 -07:00
toidiu 5ae75033ac bump version in deployment docs (#680)
* bump version in deployment docs
2019-05-07 16:17:47 +02:00
Vincent Prouillet b29596c3cc Mention the 404 page does not get current_path/current_url
Close #586
2019-05-01 23:06:05 +02:00
Vincent Prouillet 986437546c
Merge pull request #644 from getzola/next
v0.7.0
2019-04-28 10:41:12 +02:00
Vincent Prouillet debe0633bc Revert "Allow default base-path command line option to be set for building and serving"
This reverts commit 1815155c1d.
2019-04-20 12:50:34 +02:00
Wesley Moore d4a33d34ae
Add some missing words to creating a theme page 2019-04-18 07:49:17 +10:00
Vincent Prouillet 522c06e736 Update all themes 2019-04-06 11:37:58 +02:00
Sven Thiele 47c02b50b3
Update netlify.md 2019-04-05 09:35:56 +02:00
Sven Thiele 28bf071b89
Update gitlab-pages.md 2019-04-05 09:34:40 +02:00
Sven Thiele 61c6d14ffb
update zola version to v0.6.0 2019-04-05 09:31:48 +02:00
Pandark 34c18e4cbb
use travis "minimal" vm in the documentation
If not specified, Travis use a system with ruby, which we don't need. We can use the "minimal" one instead.
2019-03-28 14:02:52 +01:00
Vincent Prouillet 33d4cf14fd
Update table-of-contents.md 2019-03-26 12:32:48 +01:00
Vincent Prouillet 78c8f9cd59 Add note about Powershell ISE
Closes #530
2019-03-25 23:17:37 +01:00
Vincent Prouillet 50caf1c90c Fix typo in docs
Closes #636
2019-03-25 23:15:53 +01:00
Vincent Prouillet 5d695d7ce8
Merge pull request #567 from getzola/next
v.0.6.0
2019-03-25 20:26:07 +01:00
Blake Smith 1815155c1d Allow default base-path command line option to be set for building and serving 2019-03-23 20:25:56 -05:00
Vincent Prouillet 2a8d0de532 Pass extra for page in sitemap entries 2019-03-19 20:42:16 +01:00
Vincent Prouillet c63b7fde44 load_data now defaults to plain type + fix bug with get_taxonomy fn 2019-03-16 10:01:11 +01:00
Vincent Prouillet 7baf08cef2 Update docs for sitemap 2019-03-14 21:15:01 +01:00
Vincent Prouillet 67ddabfa8b Fix doc mentioning non-existent fields on sections 2019-02-27 17:59:09 +01:00
Jordan Shurmer bf1fd1a086
Fix minor documentation quirks in templates/overview 2019-02-27 08:54:09 -05:00
Vincent Prouillet 52cdffdfd4 Add PowerShell syntax
Fix #613
2019-02-25 18:11:30 +01:00
Eli Flanagan ce0f0ec935 use nix-shell to build on nixos
Fix #616. Add brief documentation for how to use it.
2019-02-19 19:23:27 -05:00
Vincent Prouillet 723729b6d1
Merge branch 'master' into next 2019-02-16 15:49:19 +01:00
Vincent Prouillet 705a30aa8d Move toc to be a rendering page/section variable level 2019-02-09 20:49:18 +01:00
Leonardo Schwarz 77aad07dc6 Revert "Update snap installation instructions"
This reverts commit 5fd7bf7e61.

Apparently it is not just no longer necessary to use classic
confinement, but actually impossible, i.e. snap emits an error that the
zola snap is not compatible with `--classic`.
2019-02-05 11:09:18 +01:00
Peng Guanwen 07843c116f
Fix format mistake 2019-02-03 21:46:07 +08:00
Vincent Prouillet 1c7729cac6 Default lang to config.default_language 2019-01-29 19:20:11 +01:00
Shaleen Jain 3375e7a8f1 doc: add a Github Action to deploy to Github Pages 2019-01-23 13:43:29 +05:30
Vincent Prouillet e119b68533 Remove earlier/later/lighter/heavier from pages when rendering sections 2019-01-21 17:55:05 +01:00
Vincent Prouillet 1b4cfd49d0 More early tera fns and mention limitation of shortcodes in docs 2019-01-17 18:29:18 +01:00
Ryan McGrath 0bcc706a55
One more time, Dracula theme, lol 2019-01-15 14:20:47 -08:00
Vincent Prouillet 538866487b Add multilingual taxonomies 2019-01-07 21:03:34 +01:00
Vincent Prouillet cae9223ebd Mention that serve deletes the public dir as well 2019-01-07 19:24:08 +01:00
Vincent Prouillet 3d9c27e095 Tweak to docs to mention the paragraph id for continue-reading 2019-01-07 19:21:55 +01:00
Vincent Prouillet 0f0304d7ed Mention build rm the directory 2019-01-05 11:04:12 +01:00
Noumir.Poutipou ee8087fe69 Correct a typo in the theme documentation 2019-01-04 22:00:58 +01:00
Vincent Prouillet 19075191ff Add translations to page/sections 2019-01-04 20:31:31 +01:00
Vincent Prouillet fdb6a2864c
Merge pull request #566 from vojtechkral/imgproc
Implement suggestions in #546
2018-12-30 12:44:48 +01:00
Vincent Prouillet 288917b42d Pest now requires 1.31 2018-12-29 11:38:28 +01:00
Vincent Prouillet 779511ae43 Pass down lang and start docs 2018-12-28 13:24:49 +01:00
Vojtech Kral 5348e6452e docs: Update image processing 2018-12-28 01:41:22 +01:00
Vincent Prouillet 4fb88a4056 Mention colon not allowed in filenames on windows 2018-12-18 19:46:25 +01:00
Luke Peterson 825152242d Remove redundant "From Source" documentation 2018-12-15 08:35:09 -08:00
Vincent Prouillet 5eebbc68de
Merge branch 'master' into next 2018-12-14 17:35:50 +01:00
Vincent Prouillet f193152c85 Looks like it needs 1.30? 2018-12-14 17:35:18 +01:00