mirror of
https://github.com/sass/sass.git
synced 2024-09-21 02:27:30 +00:00
Enable markdownlint checks for shortcut links
This commit is contained in:
parent
67e23c6019
commit
f91c4cda2d
@ -1,4 +1,4 @@
|
||||
# globs: ["**.md"]
|
||||
globs: ["**.md"]
|
||||
ignores: ["node_modules/**"]
|
||||
config:
|
||||
# BNF syntax examples can go over length, and there's no way to exempt them
|
||||
@ -24,4 +24,7 @@ config:
|
||||
# We use spaces in code formatting because spaces are relevant in Sass.
|
||||
no-space-in-code: false
|
||||
|
||||
reference-links-images:
|
||||
shortcut_syntax: true
|
||||
|
||||
first-line-heading: false
|
||||
|
@ -816,6 +816,8 @@ compiler.
|
||||
|
||||
A private property like [`Value.internal`] that refers to a Sass string.
|
||||
|
||||
[`Value.internal`]: ../spec/js-api/value/index.d.ts.md#internal
|
||||
|
||||
##### Constructor
|
||||
|
||||
Creates a `CalculationInterpolation` with its `internal` set to an unquoted Sass
|
||||
|
@ -1239,8 +1239,8 @@ normalized channel value otherwise.
|
||||
* Otherwise, set `channel` to the result of [percent-converting] `channel`
|
||||
with a `min` and `max` defined by the `valid` channel range.
|
||||
|
||||
* If this was (transitively) invoked from the global [`rgb()`, `lab()`,
|
||||
`lch()`, `oklab()`, `oklch()`, or `color()`] function and `valid` is a
|
||||
* If this was (transitively) invoked from the global `rgb()`, `lab()`,
|
||||
`lch()`, `oklab()`, `oklch()`, or `color()` function and `valid` is a
|
||||
clamped channel, return the result of clamping `channel` to its native
|
||||
range.
|
||||
|
||||
|
@ -41,6 +41,8 @@ to access the URL of the stylesheet that contained the load, known in the legacy
|
||||
API as the "previous URL". This was an intentional design choice which enforced
|
||||
the invariant that the same canonical URL always refers to the same file.
|
||||
|
||||
[new importer API]: new-js-importer.d.ts.md
|
||||
|
||||
However, this restriction makes it difficult for importers to work as expected
|
||||
in certain contexts. For example, in the Node.js ecosystem JS loads depend on
|
||||
the structure of the `node_modules` directory closest to the containing file.
|
||||
|
@ -141,6 +141,8 @@ should have a period of deprecation in which it emits a deprecation warning for
|
||||
a declaration whose `parent` is not the last statement in [the current module]'s
|
||||
CSS without changing the existing behavior.
|
||||
|
||||
[the current module]: ../spec/spec.md#current-module
|
||||
|
||||
> Authors can move interleaved declarations before any nested rules to preserve
|
||||
> existing behavior, or nest them in `& { ... }` style rules to anticipate the
|
||||
> new behavior.
|
||||
|
@ -143,6 +143,8 @@ since they're not specific to any individual compilation.
|
||||
The compilation ID and normal request `id` `4294967295` is reserved for [error
|
||||
handling]. (This is the maximum number representable by a `uint32`.)
|
||||
|
||||
[error handling]: #error-handling
|
||||
|
||||
### Optional and Mandatory Fields
|
||||
|
||||
If a field is not optional, the the endpoint that sends that message must
|
||||
|
@ -39,6 +39,8 @@ import {Value, SassNumber, SassString} from './index';
|
||||
|
||||
The type of values that can be arguments to a [`SassCalculation`].
|
||||
|
||||
[`SassCalculation`]: #sasscalculation
|
||||
|
||||
```ts
|
||||
export type CalculationValue =
|
||||
| SassNumber
|
||||
@ -161,6 +163,8 @@ export type CalculationOperator = '+' | '-' | '*' | '/';
|
||||
|
||||
The JS API representation of a Sass [`CalculationOperation`].
|
||||
|
||||
[`CalculationOperation`]: #calculationoperation
|
||||
|
||||
```ts
|
||||
export class CalculationOperation implements ValueObject {
|
||||
```
|
||||
|
@ -276,6 +276,8 @@ Returns `this` interpreted as a map.
|
||||
|
||||
* If `this` is a [`SassMap`], return `this`.
|
||||
|
||||
[`SassMap`]: map.d.ts.md
|
||||
|
||||
* Otherwise, if [`internal`] is an empty Sass list, return a `SassMap` with its
|
||||
`internal` set to an empty map.
|
||||
|
||||
|
@ -48,6 +48,8 @@ Creates a Sass string:
|
||||
* Set [`internal`] to a Sass string with contents set to `text` and quoted set
|
||||
to `quotes`.
|
||||
|
||||
[`internal`]: #internal
|
||||
|
||||
* Return `this`.
|
||||
|
||||
```ts
|
||||
|
@ -275,6 +275,8 @@ SCSS:
|
||||
adjacent `/`s in a [`SlashListExpression`] may have no whitespace between
|
||||
them, so `//` is parsed as two slash separators in a slash-separated list.
|
||||
|
||||
[`SlashListExpression`]: types/list.md#SlashListExpression
|
||||
|
||||
* A `ParentSelector` may appear anywhere in a `CompoundSelector`, rather than
|
||||
just as the first `SimpleSelector`.
|
||||
|
||||
|
@ -150,6 +150,8 @@ To serialize a `Number` within a `CalculationExpression`:
|
||||
This algorithm takes a [`FunctionCall`] `call` whose name is a plain identifier
|
||||
and returns a number or a calculation.
|
||||
|
||||
[`FunctionCall`]: ../functions.md#functioncall
|
||||
|
||||
* If `call`'s `ArgumentInvocation` contains one or more `KeywordArgument`s or
|
||||
one or more `RestArgument`s, throw an error.
|
||||
|
||||
@ -226,6 +228,8 @@ This algorithm takes an expression `expression` and returns a
|
||||
|
||||
* If `expression` isn't [calculation-safe], throw an error.
|
||||
|
||||
[calculation-safe]: #calculation-safe-expression
|
||||
|
||||
* Otherwise, evaluate `expression` using the semantics defined in the
|
||||
[Semantics] section if available, or the standard semantics otherwise.
|
||||
|
||||
@ -416,7 +420,9 @@ This algorithm takes a calculation `calc` and returns a number or a calculation.
|
||||
* If `strategy`'s value is `"to-zero"`, return whichever of `upper` and
|
||||
`lower` has the smallest absolute difference from 0.
|
||||
|
||||
[exactly equal]: number.md#exact-equality
|
||||
[special variable string]: ../functions.md#special-variable-string
|
||||
[matching units]: number.md#matching-two-numbers-units
|
||||
|
||||
* If `calc`'s name is `"clamp"`:
|
||||
|
||||
|
@ -51,7 +51,7 @@ absolute value is larger than the length of that list.
|
||||
## Syntax
|
||||
|
||||
<x><pre>
|
||||
**BracketedListExpression** ::= '[' ContainedListExpression ']'
|
||||
**BracketedListExpression** ::= '\[' ContainedListExpression ']'
|
||||
**ContainedListExpression** ::= CommaListExpression ','?
|
||||
**CommaListExpression** ::= SlashListExpression (',' SlashListExpression)*
|
||||
**SlashListExpression** ::= SpaceListExpression (('/' SpaceListExpression?)* '/' SpaceListExpression)?
|
||||
|
Loading…
Reference in New Issue
Block a user