picopygments.yml 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. ## variables commented out with a single #hash represent default values.
  2. ##
  3. ## Since PicoPygments has no dependencies PicoCMS will enable it by default.
  4. ## You can disable it by setting this to false:
  5. ##
  6. PicoPygments:
  7. enabled: true
  8. ## Class to use for code blocks with language definitions.
  9. ## Additionally, the "language-$lang" class is preserved.
  10. #cssclass: "pcpg"
  11. ## Template to activate this plugin for. Pass "all" to activate for all pages.
  12. ## (Nevertheless, this plugin only springs into action when a code block with
  13. ## a language definition is found.)
  14. #template: "post"
  15. ## Add a link to this CSS.
  16. ## This will override any tagblog.colors set in PicoCMS' config.
  17. ## You can find a choice of styles in the plugin's css directory,
  18. ## generated with the styles.py script therein.
  19. ## Each color CSS also imports _common.css from the same folder.
  20. #stylesheet: "/plugins/PicoPygments/css/generated/base16-equilibrium-dark-var.css"
  21. ## Use this as your python command.
  22. ## If you can, try to minimize resource usage, e.g.: python_cmd: "/usr/bin/python3m -I"
  23. #python_cmd: "python3 -I"
  24. python_cmd: "python3 -s -I"
  25. ## An existing directory to cache pygments-generated results. This highly reduces
  26. ## page loading times since python isn't called at all if all code blocks have been cached already.
  27. ## Make sure this is set to a path the web server has permissions to read+write. The directory and
  28. ## parents will be created as required. But the plugin works just fine without caching, too.
  29. cache_dir: "/dev/shm/cache/pico-staging/PicoPygments"
  30. ## Inserts a <div class="corner"> between the <pre> and the <code> element. It contains the language of the code block.
  31. ## This can be pushed to the top right corner of the code block (see css/_common.css). Set it to true or false.
  32. label: true
  33. ## If you set 'debug: true' in your main config.yml, the plugin will spew out debug messages.
  34. ## If you set the below to true, it will spew out _much_ more - including raw html output.
  35. #debug_xtra: false
  36. ## DANGER ZONE
  37. ## We pass options to the Pygments lexer (what parses the code) and the HTML formatter.
  38. ## If you want - and are sure you know what you're doing - you can change the whole
  39. ## optionstring for both. Here are the defaults:
  40. #lexeroptions: 'encoding="utf-8"'
  41. #formatteroptions: 'nowrap=True'
  42. ## Please refer to https://pygments.org/docs/lexers/ and https://pygments.org/docs/formatters/#HtmlFormatter