docs/usage_and_configuration/index.md

   1 # Usage and Configuration
   2
   3 ```{toctree}
   4 ---
   5 hidden:
   6 ---
   7
   8 the_basics
   9 file_collection_and_discovery
  10 black_as_a_server
  11 black_docker_image
  12 ```
  13
  14 Sometimes, running _Black_ with its defaults and passing filepaths to it just won't cut
  15 it. Passing each file using paths will become burdensome, and maybe you would like
  16 _Black_ to not touch your files and just output diffs. And yes, you _can_ tweak certain
  17 parts of _Black_'s style, but please know that configurability in this area is
  18 purposefully limited.
  19
  20 Using many of these more advanced features of _Black_ will require some configuration.
  21 Configuration that will either live on the command line or in a TOML configuration file.
  22
  23 This section covers features of _Black_ and configuring _Black_ in detail:
  24
  25 - {doc}`The basics <./the_basics>`
  26 - {doc}`File collection and discovery <file_collection_and_discovery>`
  27 - {doc}`Black as a server (blackd) <./black_as_a_server>`
  28 - {doc}`Black Docker image <./black_docker_image>`