picogeshi.yml 3.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. ## variables commented out with a single #hash represent default values.
  2. ##
  3. ## Since PicoGeSHi has no dependencies PicoCMS will enable it by default.
  4. ## You can disable it by setting this to false:
  5. ##
  6. #PicoGeSHi.enabled: true
  7. #geshi:
  8. ## class to use for code blocks with language definitions (additionally, the
  9. ## "language-$lang" class is preserved, and the "$lang" class is added)
  10. ## If you change this you also need to change the css_template, if you want
  11. ## colors applied.
  12. #class: "geshi"
  13. ## Enable _plain_ line-numbering ?
  14. ## Please note that this value and the next are independent of each other
  15. ## - in other words: it is enough and recommended to enable only one
  16. ## true | false
  17. #line-numbers: false
  18. ## Alternate styling for lines every (fancy-line-numbers) row
  19. ## must be greater than 1 to be applied
  20. #fancy-line-numbers: 0
  21. ## start numbering at (default: 0)
  22. #line-start: 0
  23. ## enable chapter id for each line - this does not turn line numbers into links.
  24. #enable-ids: false
  25. ## template to activate this plugin for. Pass "all" to activate for all pages
  26. ## (nevertheless, GeSHi is only initialized when a code block with a language
  27. ## definition is found)
  28. #template: "post"
  29. ## load this css color template (below colors will be inserted):
  30. ## path is relative to the PicoGeSHi dir, where PicoGeSHi.php resides
  31. #css_template: "default.template.css"
  32. ## If you want the plugin to provide colors, you need to set the following to true.
  33. ## The plugin will still add the appropriate classes if you explicitely set it to
  34. ## false; that way one could apply separate CSS rules by some other means.
  35. ## This setting defaults to true however, and if no colors are set the plugin
  36. ## _will_ provide colors, defaulting to the following fallbacks.
  37. ##
  38. #geshi_col:
  39. # enabled: true
  40. ## To avoid incompatibilities between dark and light themes, white and black do
  41. ## not exist, instead there's two foreground colors and two background colors.
  42. ## The other colors are named analogously to e.g. terminal color schemes.
  43. ##
  44. ## Ideally, these are defined in your PicoCMS theme's (colors-...) YAML config
  45. ## and not here. Use any color format that twig can read and CSS understands.
  46. ## If you set geshi_col.enabled to true (it defaults to true) but don't define
  47. ## any colors, the below fallbacks are used, with a light (dark text on light
  48. ## background) theme in mind (see www.w3schools.com/cssref/css_colors.asp):
  49. ##
  50. # fg_def: Black # default text
  51. # fg_alt: DimGrey # alternative text
  52. # bg_def: Mocassin # default background
  53. # bg_alt: OldLace # default background
  54. # ## red dark/light
  55. # col1: DarkRed
  56. # col9: FireBrick
  57. # ## green dark/light
  58. # col2: ForestGreen
  59. # col10: LawnGreen
  60. # ## yellow dark/light
  61. # col3: GoldenRod
  62. # col11: Gold
  63. # ## blue dark/light
  64. # col4: CadetBlue
  65. # col12: CornflowerBlue
  66. # ## magenta dark/light
  67. # col5: DarkViolet
  68. # col13: DarkOrchid
  69. # ## cyan dark/light
  70. # col6: DarkCyan
  71. # col14: DeepSkyBlue