sass-site/source/documentation/index.liquid

67 lines
2.7 KiB
Plaintext
Raw Normal View History

2023-05-07 18:58:40 +02:00
---
title: 'Documentation'
introduction: >
Sass is a stylesheet language thats compiled to CSS. It allows you to use
[variables](/documentation/variables), [nested
rules](/documentation/style-rules#nesting),
[mixins](/documentation/at-rules/mixin),
[functions](/documentation/modules), and more, all with a fully
CSS-compatible syntax. Sass helps keep large stylesheets well-organized and
makes it easy to share design within and across projects.
---
2023-05-23 18:24:23 +02:00
{% markdown %}
2023-05-07 18:58:40 +02:00
- If you're looking for an introduction to Sass, check out [the
tutorial](/guide).
- If you want to look up a built-in Sass function, look no further than [the
built-in module reference](/documentation/modules).
- If you're calling Sass from JavaScript, you may want the [JS API
documentation][js].
- Or the [Dart API documentation][dart] if you're calling it from Dart.
- Otherwise, use the table of contents for the language reference!
[js]: https://github.com/sass/node-sass#usage
[dart]: https://pub.dartlang.org/documentation/sass/latest/sass/sass-library.html
## Older Versions
This documentation is written for the most recent version of the Sass language.
2023-05-23 14:47:17 +02:00
If you're using [Dart Sass] {{ releases['dart-sass'].version }}, you'll have access to
2023-05-07 18:58:40 +02:00
all the features described here. But if you're using an older version of Dart
Sass or a deprecated Sass implementation like [LibSass] or [Ruby Sass], there
may be some behavioral differences.
[Dart Sass]: /dart-sass
[LibSass]: /libsass
[Ruby Sass]: /ruby-sass
Anywhere behavior differs between versions or implementations, the documentation
includes a compatibility indicator like this:
2023-05-23 18:24:23 +02:00
{% endmarkdown %}
2023-05-07 18:58:40 +02:00
2023-05-24 19:11:47 +02:00
{% # Arguments are (in order): `dart`, `libsass`, `node`, `ruby`, optional feature name, additional details within %}
{% compatibility true, '3.6.0', null, false, 'Feature Name' %}{% endcompatibility %}
2023-05-07 18:58:40 +02:00
2023-05-23 18:24:23 +02:00
{% markdown %}
2023-05-07 18:58:40 +02:00
Implementations with a "✓" fully support the feature in question, and
implementations with a "✗" don't support it all. Implementations with a version
number started supporting the feature in question at that version.
Implementations can also be marked as "partial":
2023-05-23 18:24:23 +02:00
{% endmarkdown %}
2023-05-07 18:58:40 +02:00
2023-05-24 19:11:47 +02:00
{% # Arguments are (in order): `dart`, `libsass`, `node`, `ruby`, optional feature name, additional details within %}
{% compatibility true, 'partial', null, false %}
2023-05-23 18:24:23 +02:00
Additional details go here.
{% endcompatibility %}
2023-05-07 18:58:40 +02:00
2023-05-23 18:24:23 +02:00
{% markdown %}
2023-05-07 18:58:40 +02:00
This indicates that the implementation only supports some aspects of the
feature. These compatibility indicators (and many others) have a "▶" button,
which can be clicked to show more details about exactly how the implementations
differ and which versions support which aspects of the feature in question.
2023-05-23 18:24:23 +02:00
{% endmarkdown %}