latex-structure-shading README

Features

Make it easier to navigate your chapters by this subtle structure highlighting of your LaTeX document. The color scheme is based on the default light and dark themes of Visual Studio Code, and is designed to be subtle and not distracting. Colors change automatticly when a new chapter is started.

Lines are also added between chapers (solid) and sections (dashed) to further enhance the visual separation of different parts of the document.

Dots are also shown in the gutter to indicate the current section, making it easier to keep track of where you are in the document, as can be seen in \ref{feature 1}.

Requirements

None.

Adjusting settings

LaTeX Structure Shading adds settings in the VS Code Settings UI and in settings.json.

Open them by searching for LaTeX Structure Shading in Settings, or edit settings.json directly.

What can be customized

• turn background shading on or off
• turn main and secondary separator lines on or off
• turn gutter dots on or off
• change the light-theme and dark-theme color palettes
• change alpha levels for the main and secondary bands
• change the regex used to detect the main and secondary structure levels
• change the gutter dot sizes

Default behavior

By default:

• main level = \chapter{...}
• secondary level = \section{...}

That means the extension is ideal for book, report, and memoir-style LaTeX documents.

Example: custom palette

You can use either hex colors or rgb(...) / rgba(...).

"latexStructureShading.lightPalette": [
  "#fce4ec",
  "#e3f2fd",
  "rgb(232, 245, 233)",
  "#fff8e1",
  "#f3e5f5",
  "#e0f7fa",
  "#f1f8e9"
],
"latexStructureShading.darkPalette": [
  "#5a282d",
  "#23375a",
  "#234b2d",
  "#5a4b1e",
  "#462d55",
  "rgb(30, 75, 85)",
  "#3a3f1f"
]

## Release Notes

Initial release of LaTeX Structure Shading.

### 1.0.0

Initial release