Commit Graph

745 Commits

Author SHA1 Message Date
Natalie Weizenbaum
e7ffef4fc9 Avoid an unstyled rendering moment with the tables of contents
Tables of contents are now statically rendered in their appropriately
open/closed states, rather than updated via JavaScript, so they render
correctly on the first page load. In order to make the "page sections"
table still usable without JS, this adds a stylesheet in a <noscript>
tag that forces the sections into an open state.
2019-04-12 00:09:10 -07:00
Natalie Weizenbaum
ce9244b504
Tweak typography to improve legibility (#318)
* Add more margin above headers to visually associate them with the
  prose below, rather than above.

* Reduce the margin around normal block elements to more clearly
  associate them with one another.

* Increase the size of prose and medium/large headers to make them
  easier to see.

* Reduce the font weight of intro paragraphs to make them more
  visually distinct from the rest of the documentation.

Based on @slimekat's suggestions.

Closes #313
2019-04-11 15:30:17 -07:00
Natalie Weizenbaum
de561b2370
Make the reference tables of contents collapsible (#320) 2019-04-11 15:30:10 -07:00
Natalie Weizenbaum
e1ceec2fce
Merge pull request #323 from sass/cli-docs
Update Dart Sass CLI documentation
2019-04-08 14:49:19 -07:00
Natalie Weizenbaum
d87eeab0a3 Update Dart Sass error examples to match the current output 2019-04-07 17:01:48 -07:00
Natalie Weizenbaum
96632b9c02 Document the --unicode flag
See sass/dart-sass#566
2019-04-07 16:43:49 -07:00
Natalie Weizenbaum
bfff691df2 Document the --no-charset flag
See sass/dart-sass#644
2019-04-07 16:39:53 -07:00
Natalie Weizenbaum
7120ef2432
Indicate that Ruby Sass is end-of-life (#319)
Closes #206
2019-04-05 15:48:12 -07:00
Natalie Weizenbaum
bf21b7f160
Merge pull request #317 from sass/adjacent-tabs
Render syntax examples using adjacent tabs if they're narrow enough

Closes #311
2019-04-04 23:56:06 -07:00
Natalie Weizenbaum
4b6b15b1ab
Add special styling for intro pages (#316)
This just bumps up the font size a bit, to help emphasize that these
pages are special and make them look less bare.

Closes #276
2019-04-04 23:55:07 -07:00
Natalie Weizenbaum
aaafdcee05 Redirect /blog/* to Logdown 2019-04-03 17:40:45 -07:00
Natalie Weizenbaum
d42fca01ff Remove the Maps introduction paragraph
This code examples in this paragraph don't fit in the larger font
size.
2019-04-03 16:39:35 -07:00
Natalie Weizenbaum
3d20c8f536 Fix some broken Markdown links 2019-04-03 16:38:26 -07:00
Natalie Weizenbaum
be95e0c7df Allow examples to split even if they can't split in the middle 2019-03-28 19:13:31 -07:00
Natalie Weizenbaum
f56c48cafc Render syntax examples using adjacent tabs if they're narrow enough
Closes #311
2019-03-28 19:13:22 -07:00
Natalie Weizenbaum
31ade4eebd Don't make syntax switcher arrows invisible in callouts (#312)
I'm not sure why this was done initially, but it seems wrong?
2019-03-20 03:47:13 +02:00
Natalie Weizenbaum
65a216628a
Merge pull request #301 from sass/function-return
Include return types in function signatures
2019-03-19 14:01:05 -07:00
Natalie Weizenbaum
416f463590 Properly display newlines in function signatures 2019-03-19 13:56:21 -07:00
Natalie Weizenbaum
e22698388e
Merge branch 'wip.reference' into function-return 2019-03-19 13:40:00 -07:00
Natalie Weizenbaum
78429ae1b4
Add permalink icons to function API docs (#309)
Closes #308
2019-03-18 17:49:03 -07:00
Natalie Weizenbaum
4e6eb090a4
Merge pull request #306 from sass/impl-status
Tweak impl status styling
2019-03-18 17:48:47 -07:00
Natalie Weizenbaum
e3eb8cc442 Clarify that multiple / operations aren't treated as divison
Closes #303
2019-03-11 17:38:45 -07:00
Natalie Weizenbaum
b8fd618da7 Document forbidden assignment to non-existent global variables
Closes #285
2019-03-11 17:37:27 -07:00
Natalie Weizenbaum
36a1610c62 Always select SCSS by default 2019-03-11 02:02:38 -07:00
Natalie Weizenbaum
1d718a3fb3
Merge branch 'wip.reference' into function-return 2019-03-10 23:23:00 -07:00
Natalie Weizenbaum
d0c1079b78
Merge branch 'wip.reference' into impl-status 2019-03-10 23:22:02 -07:00
Natalie Weizenbaum
3b1a93afe9 Add a light border to callouts (#300)
This helps them stand out a tiny bit more, especially in functions
where their backgrounds are very similar to the function background.
2019-03-10 09:11:48 -05:00
Natalie Weizenbaum
f24f5927cd Fix the whitespace above code examples once and for all (#304)
Closes #302
2019-03-10 09:10:50 -05:00
Natalie Weizenbaum
8a655f20da
Merge pull request #307 from sass/travis
Fix broken links and enable Travis for wip.reference
2019-03-09 00:00:12 -08:00
Natalie Weizenbaum
e6b9153af0 Don't check any external URLs on Travis 2019-03-08 18:10:27 -08:00
Natalie Weizenbaum
f9bb65a701 Use Ruby 2.5.3 on Travis 2019-03-08 18:03:06 -08:00
Natalie Weizenbaum
e1ca4ff5de Always run Travis on the wip.reference branch 2019-03-08 17:57:50 -08:00
Natalie Weizenbaum
0ce28695ce Fix broken links 2019-03-08 17:57:33 -08:00
Natalie Weizenbaum
47c4de8279 Always get rid of newlines when concatenating chunks of HTML
This avoids weirdness with HTML within Markdown.
2019-03-08 17:52:45 -08:00
Natalie Weizenbaum
4c58ef0739 Add a partial support state for impl statuses 2019-03-08 17:11:11 -08:00
Natalie Weizenbaum
482542ac08 Add a header for impl status bars
This gives us a place to disambiguate between implementation statuses
that refer to the entire feature under discussion, and those that just
refer to sub-features.
2019-03-08 16:48:27 -08:00
Natalie Weizenbaum
7fd5bd1c7a Tweak impl status styling
* Make the font smaller to make them less prominent and help visually
  associate the callout with the list.
* Decrease the top margin to more clearly associate them with their
  preceding header.
* Lighten the callout background when in another callout to make it
  more visible.
* Animate the expand button.
2019-03-08 16:45:43 -08:00
Natalie Weizenbaum
681d63c698 Follow the style guide for implementation notes 2019-03-08 15:26:48 -08:00
Natalie Weizenbaum
488d656af3 Add a docsearch class to the has_no_sidebars layout
This ensures the Ruby Sass, Dart Sass, and Install pages get indexed.
2019-03-07 11:51:42 -08:00
Natalie Weizenbaum
93b739b04f Show SCSS syntax by default 2019-03-04 19:32:49 -08:00
Jina Anne
f6f238b3ea callout update 2019-03-04 19:11:26 -08:00
Jina Anne
902ca93412 Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2019-03-04 18:36:39 -08:00
Jina Anne
e541d4a6ef impl 2019-03-04 18:36:34 -08:00
Natalie Weizenbaum
ce1dfc1585 Fix some mixed-up links 2019-03-04 18:30:15 -08:00
Jina Anne
50eef3ca48 Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2019-03-04 18:29:30 -08:00
Jina Anne
ac992b3233 implementation 2019-03-04 18:29:20 -08:00
Natalie Weizenbaum
40e116a9ed Include return types in function signatures
Closes #298
2019-03-04 18:28:38 -08:00
Natalie Weizenbaum
8274243798 Fix a typo 2019-03-04 18:08:04 -08:00
Jina Anne
aa8ba21b75 fix code 2019-03-04 18:07:39 -08:00
Jina Anne
ff521bdbd0 fix code 2019-03-04 18:06:06 -08:00