mirror of
https://github.com/gohugoio/hugo.git
synced 2025-05-02 09:59:08 +00:00
358dcce7a6
See #470 * Based on existing support for reStructuredText files * Handles content files with extensions `.asciidoc` and `.ad` * Pipes content through `asciidoctor --safe -`. If `asciidoctor` is not installed, then `asciidoc --safe -`. * To make sure `asciidoctor` or `asciidoc` is found, after adding a piece of AsciiDoc content, run `hugo` with the `-v` flag and look for this message: INFO: 2015/01/23 Rendering with /usr/bin/asciidoctor ... Caveats: * The final "Last updated" timestamp is currently not stripped. * When `hugo` is run with `-v`, you may see a lot of these messages INFO: 2015/01/23 Rendering with /usr/bin/asciidoctor ... if you have lots of `*.ad`, `*.adoc` or `*.asciidoc` files. * Some versions of `asciidoc` may have trouble with its safe mode. To test if you are affected, try this: $ echo "Hello" | asciidoc --safe - asciidoc: ERROR: unsafe: ifeval invalid asciidoc: FAILED: ifeval invalid safe document If so, I recommend that you install `asciidoctor` instead. Feedback and patches welcome! Ideally, we should be using https://github.com/VonC/asciidocgo, @VonC's wonderful Go implementation of Asciidoctor. However, there is still a bit of work needed for asciidocgo to expose its API so that Hugo can actually use it. Until then, hope this "experimental AsciiDoc support through external helpers" can serve as a stopgap solution for our community. :-) 2015-01-30: Updated for the replaceShortcodeTokens() syntax change 2015-02-21: Add `.adoc` extension as suggested by @Fale Conflicts: helpers/content.go |
||
|---|---|---|
| .. | ||
| author.go | ||
| benchmark_test.go | ||
| handler_base.go | ||
| handler_file.go | ||
| handler_meta.go | ||
| handler_page.go | ||
| hugo.go | ||
| media.go | ||
| menu.go | ||
| menu_test.go | ||
| node.go | ||
| page.go | ||
| page_permalink_test.go | ||
| page_taxonomy_test.go | ||
| page_test.go | ||
| page_time_integration_test.go | ||
| pageGroup.go | ||
| pageGroup_test.go | ||
| pageSort.go | ||
| pagesPrevNext.go | ||
| pagesPrevNext_test.go | ||
| pagination.go | ||
| pagination_test.go | ||
| path_separators_test.go | ||
| path_separators_windows_test.go | ||
| permalinks.go | ||
| permalinks_test.go | ||
| planner.go | ||
| redis.cn.md | ||
| rss_test.go | ||
| scratch.go | ||
| scratch_test.go | ||
| shortcode.go | ||
| shortcode_test.go | ||
| shortcodeparser.go | ||
| shortcodeparser_test.go | ||
| site.go | ||
| site_show_plan_test.go | ||
| site_test.go | ||
| site_url_test.go | ||
| siteinfo_test.go | ||
| sitemap.go | ||
| sitemap_test.go | ||
| summary.go | ||
| taxonomy.go | ||
| taxonomy_test.go | ||