Page MenuHomeFreeBSD

Add support to Hugo arguments/flags
ClosedPublic

Authored by dbaio on Sat, Jun 5, 1:14 PM.

Details

Summary

This also enables verbose output by default, same behavior we had in the
doc tree before Hugo/Asciidoctor.

Test Plan

Arguments for our ci:

$ make HUGO_ARGS="--verbose --debug --path-warnings"
---------------------------------------------------------------
Building the website started on Sat Jun  5 10:07:17 -03 2021
---------------------------------------------------------------
/usr/local/bin/python3 ./tools/releases-toml.py -p ./shared/releases.adoc
/usr/local/bin/hugo --verbose --debug --path-warnings
INFO 2021/06/05 10:07:17 Translation func for language it not found, use default.
INFO 2021/06/05 10:07:17 Translation func for language hu not found, use default.
INFO 2021/06/05 10:07:17 Using config file:
Start building sites …
INFO 2021/06/05 10:07:17 syncing static files to /usr/home/dbaio/FreeBSD/git/doc/website/public/
DEBUG 2021/06/05 10:07:17 Render page FreeBSD's Privacy Policy to "/privacy/index.html
[...]
DEBUG 2021/06/05 10:06:36 Render page Снэпшот-релизы FreeBSD to "/ru/snapshots/feed.xml"
DEBUG 2021/06/05 10:06:36 Render page Поддержка to "/ru/support/feed.xml"
DEBUG 2021/06/05 10:06:36 Render page Учебники по FreeBSD to "/ru/tutorials/feed.xml"
DEBUG 2021/06/05 10:06:36 Render XML for "sitemapindex" to "sitemap.xml"
DEBUG 2021/06/05 10:06:36 Render Robots Txt to "robots.txt"

                   |  EN  |  DE  |  ES  |  JA  | ZH-CN | ZH-TW |  NL  |  IT  |  HU  |  FR  |  RU
-------------------+------+------+------+------+-------+-------+------+------+------+------+-------
  Pages            |  976 |   81 |   75 |  111 |    45 |    29 |   20 |   18 |   73 |  185 |  189
  Paginator pages  |    0 |    0 |    0 |    0 |     0 |     0 |    0 |    0 |    0 |    0 |    0
  Non-page files   |  679 |  161 |    4 |    4 |   128 |     0 |    0 |    2 |    2 |    4 |   54
  Static files     | 2891 | 2891 | 2891 | 2891 |  2891 |  2891 | 2891 | 2891 | 2891 | 2891 | 2891
  Processed images |    0 |    0 |    0 |    0 |     0 |     0 |    0 |    0 |    0 |    0 |    0
  Aliases          |    1 |    0 |    0 |    0 |     0 |     0 |    0 |    0 |    0 |    0 |    0
  Sitemaps         |    2 |    1 |    1 |    1 |     1 |     1 |    1 |    1 |    1 |    1 |    1
  Cleaned          |    0 |    0 |    0 |    0 |     0 |     0 |    0 |    0 |    0 |    0 |    0

WARN 2021/06/05 10:06:36 Duplicate target paths: /usr/home/dbaio/FreeBSD/git/doc/website/public/de/community/index.html (2), /usr/home/dbaio/FreeBSD/git/doc/website/public/de/platforms/ia64/index.html (2)
Total in 107466 ms
---------------------------------------------------------------
Building the website completed on Sat Jun  5 10:06:36 -03 2021
---------------------------------------------------------------

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

dbaio requested review of this revision.Sat, Jun 5, 1:14 PM
dbaio created this revision.

Good idea. Looks good.

This revision is now accepted and ready to land.Sat, Jun 5, 1:44 PM
allanjude added a subscriber: allanjude.

Reviewed By: allanjude

  • Add --minify to HUGO_ARGS variable to make it optional
This revision now requires review to proceed.Sat, Jun 5, 5:05 PM
This revision is now accepted and ready to land.Sat, Jun 5, 5:11 PM
imp added a subscriber: imp.

I think this looks good too... the comment is more a FYI in case you wanted to fix that under a different review :)

documentation/Makefile
82

tangential bug: $(.HOST) should be $(BIND) when BIND is set, otherwise the baseURL will go to the localhost of the remote machine and fail.

documentation/Makefile
82

Thanks, I'll open another review for it

This revision was automatically updated to reflect the committed changes.