Commit Graph

567 Commits

Author SHA1 Message Date
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
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
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
0ce28695ce Fix broken links 2019-03-08 17:57:33 -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
Jina Anne
0408f08bd7 improve search box alignment 2019-03-04 18:03:07 -08:00
Jina Anne
2aea914aef Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2019-03-04 17:54:40 -08:00
Jina Anne
24fd1d9dd3 type tweak 2019-03-04 17:51:45 -08:00
Natalie Weizenbaum
0e8da5c350 Don't use :code for code blocks (#296)
For some reason, :code seems to add an empty line at the end of its
code block. This uses Markdown code blocks instead, although in order
to work around a RedCarpet bug it has to indent them strangely.
2019-03-04 19:46:32 -06:00
Jina Anne
1172c29570 impl-status styling 2019-03-04 17:27:20 -08:00
Jina Anne
03372dc401 style functions 2019-03-04 17:19:06 -08:00
Jina Anne
6a67728ab5 fix nav item spacing 2019-03-04 16:59:06 -08:00
Jina Anne
97042a5a28 make nav code not wrap 2019-03-04 16:55:24 -08:00
Jina Anne
096c6512f3 condense home 2019-03-04 16:50:23 -08:00
Jina Anne
94c9c002ec make call outs less… called out 2019-03-04 16:24:31 -08:00
Jina Anne
8aa45d75a3 make syntax switcher heading unique 2019-03-04 14:41:21 -08:00
Jina Anne
fcff312333 un-contain the dart sass page 2019-03-04 14:03:41 -08:00
Jina Anne
94aa8c62e0 fix ruby sass page 2019-03-04 13:57:56 -08:00
Natalie Weizenbaum
7cc3b1b375 Automatically add nice header linking behavior (#280)
* Make link headers look and work more like GitHub's

* Automatically generate links for all headers

* Flash headers when they're selected

* update readme
2019-03-04 15:16:52 -06:00
Ihor Sychevskyi
702fb86f23 upd current date (#278) 2019-03-04 15:09:01 -06:00
Natalie Weizenbaum
77311c93f9 Disable word wrapping for p code (#281) 2019-03-04 15:07:29 -06:00
Natalie Weizenbaum
8805a7ce33 Enable Algolia search (#289)
* Enable Algolia search

This adds:

* Algolia bootstrap JS.
* A search bar (without styling)
* A "docSearch-content" class to the main reference doc container, so
  the sidebars don't get indexed.
* A "docSearch-function" class to function names, so that they'll be
  indexed.

* Fix a few lints
2019-03-04 15:05:59 -06:00
Natalie Weizenbaum
05601451cd Fix the sitemap (#290)
Closes #286
2019-03-04 15:05:31 -06:00
Natalie Weizenbaum
d4eb2ef3f1 Always use HTTPS (#291)
* Make all links to the Sass site use HTTPS

* Force all requests to use HTTPS
2019-03-04 15:04:23 -06:00
Scott Kellum
9f3dc12a2c Modify the respectful language to include those outside the Sass community as well (#292) 2019-03-04 15:02:50 -06:00
onbcst
e8260e80e8 Rewrite python section. (#282)
The last commit to `python-scss` dates back to 2014.
2019-02-25 17:05:24 -08:00
Natalie Weizenbaum
e6771747ad Enable html-proofer for the new docs, and fix errors 2019-01-09 14:36:31 -08:00
Natalie Weizenbaum
62fa63b67a Fix some typos 2019-01-04 15:04:18 -05:00
Jina Anne
7ee1b68df5 link header 2018-12-28 18:03:50 -08:00
Jina Anne
4785328dff hover link 2018-12-28 18:01:32 -08:00
Jina Anne
c21200ba14 header linking 2018-12-28 17:59:53 -08:00
Jina Anne
fb5eb4f52c Clean up style guide 2018-12-28 17:26:36 -08:00
Jina Anne
9a4d66643e add list documentation 2018-12-28 17:03:29 -08:00
Jina Anne
c0478b1f89 remove broken sticky plugin 2018-12-28 16:50:04 -08:00
Jina Anne
6db6cad349 nav progress 2018-12-28 16:42:05 -08:00
Jina Anne
698ff52e1d remove nav border 2018-12-28 16:32:00 -08:00
Jina Anne
1a9e640fb3 Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2018-12-28 16:29:26 -08:00
Jina Anne
39263a13e3 update layout 2018-12-28 16:29:22 -08:00
Natalie Weizenbaum
e993e6bf42 Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2018-12-28 16:28:01 -08:00
Natalie Weizenbaum
c5a569055e Disable directory_indexes
Instead of compiling everything to directories containing index files,
we now compile to plain HTML files and rely on Rack::TryStatic to load
them.
2018-12-28 16:26:21 -08:00
Jina Anne
c7f02d1a44 more visible links 2018-12-28 16:13:58 -08:00
Jina Anne
1a3866c053 new community page 2018-12-28 15:56:52 -08:00
Natalie Weizenbaum
7f886f13ee Link to GitHub for Ruby Sass release notes 2018-12-28 15:45:13 -08:00
Natalie Weizenbaum
170352c8d0 Update Hampton's website link
It looks like the old link is broken.
2018-12-28 15:41:14 -08:00
Jina Anne
c95e419902 fix email 2018-12-28 15:27:34 -08:00
Jina Anne
644337a512 fix reference layout 2018-12-28 15:22:59 -08:00
Natalie Weizenbaum
06e0f29f93 Fix a merge error 2018-12-28 15:18:05 -08:00
Jina Anne
6207f9e069 update normalize 2018-12-28 15:10:31 -08:00
Jina Anne
5c23b769eb add headings to navs 2018-12-28 15:04:28 -08:00
Natalie Weizenbaum
25a40e45f9 Pad the syntax switcher with newlines rather than CSS padding (#266)
* Pad the syntax switcher with newlines rather than CSS padding

* Style nit
2018-12-28 14:57:14 -08:00
Jina Anne
936bc03a6c fix syntax errors 2018-12-28 14:55:48 -08:00
Natalie Weizenbaum
97c5ac21af Put the table of contents where it's supposed to go (#267) 2018-12-28 14:49:59 -08:00
Jina Anne
8b2d48f774 merge in master 2018-12-27 19:47:31 -08:00
Jina Anne
a139d47482 fix other layouts 2018-12-27 19:12:55 -08:00
Jina Anne
17077282d3 Merge branch 'wip.reference' of github.com:sass/sass-site into wip.reference 2018-12-27 19:07:06 -08:00
Jina Anne
3789242778 fix layout? 2018-12-27 19:07:00 -08:00
Natalie Weizenbaum
c344861698 Fix a typo 2018-12-27 18:12:55 -08:00
Jina Anne
69272daa3b
fix arrow icon with unicode character (#235)
* fix arrow icon with unicode character

* use bigger, bolder arrow
2018-12-27 17:33:42 -08:00
Natalie Weizenbaum
da252a276d Clarify exactly how long Ruby Sass will be maintained (#240) 2018-12-27 17:33:19 -08:00
Natalie Weizenbaum
b67fc7928b Add htmlproofer to verify links (#252)
* Add htmlproofer to verify links

Partially addresses #247

* Make htmlproofer a Rake task

* Verify that we don't have leftover Markdown links

* Don't build the full Ruby Sass docs before running htmlproofer

* Don't check generated documentation

* Fix a few more broken links

* Add another URL exception

* Limit which branches we run tests for

* Add more URL exceptions
2018-12-27 17:32:58 -08:00
Kaelig Deloumeau-Prigent
2f60b6ae2a Delete extraneous backwards slashes in Import section (#261) 2018-12-27 17:28:39 -08:00
Natalie Weizenbaum
d39671f9cd Document the new escaped tab behavior (#264)
See https://github.com/sass/sass/issues/2590
2018-12-27 17:25:06 -08:00
Jina Anne
e9d0793c1f make nav conditional 2018-12-27 17:19:19 -08:00
Jina Anne
5787e37007 clarify syntax 2018-12-27 17:04:10 -08:00
Jina Anne
4a5ee52092 fixes #262 2018-12-27 17:02:45 -08:00
Jina Anne
67020d2037 merge conflicts 2018-12-27 16:50:00 -08:00
Jina Anne
92d9baf850 fix nav 2018-12-27 16:43:43 -08:00
Jina Anne
66f3526bd5 major clean up 2018-12-27 16:31:28 -08:00
Natalie Weizenbaum
c56cbdc2e5 Fix a typo 2018-12-20 16:36:26 -08:00
Natalie Weizenbaum
a066703e22 Document rgba($color, $alpha)
Closes #254
2018-12-04 13:35:27 -08:00
Natalie Weizenbaum
6b015247a3 Document passing special functions to rgb() and hsl()
Closes #253
2018-12-03 18:39:07 -08:00
Natalie Weizenbaum
dd374df934 Add a heads-up about slash-separated arguments to rgb() 2018-12-03 18:19:05 -08:00
Natalie Weizenbaum
459af4324e Document the new rgb() and hsl() syntax
Closes #251
2018-12-03 17:25:01 -08:00
Natalie Weizenbaum
1de307796d Add redirects from old documentation locations to new ones 2018-12-03 16:41:00 -08:00
Natalie Weizenbaum
6a05e6af00 Remove an unused HTML page for the railroad diagram 2018-11-29 17:25:06 -08:00
Natalie Weizenbaum
378efd127c Embed the railroad diagram as an object
Including it inline caused some conflicts with the markdown parser.
2018-11-29 17:23:23 -08:00
Natalie Weizenbaum
c4c81ab60a Fix build errors 2018-11-29 17:04:51 -08:00
Natalie Weizenbaum
b78ca9d10c Add zero-width spaces before #-style comments in code blocks
Otherwise, Redcarpet interprets them as headers when generating the
table of contents. See vmg/redcarpet#664.
2018-11-29 16:04:00 -08:00
Natalie Weizenbaum
f34a7b87a6
Add a table of contents to select documentation pages (#260) 2018-11-29 15:43:18 -08:00
Natalie Weizenbaum
180d0c9e09 Document @content arguments
Closes #250
2018-11-05 17:53:30 -08:00
Natalie Weizenbaum
c8ff09b5eb Document interpolated at-rule names
Closes #249
2018-11-05 17:36:26 -08:00
Natalie Weizenbaum
61e86f4322 Document range-form media queries
Closes #248
2018-11-05 17:33:48 -08:00
Natalie Weizenbaum
6f7e4929ec Document SASS_PATH 2018-10-31 17:09:57 -07:00
Natalie Weizenbaum
29c32eec1a Merge remote-tracking branch 'origin/wip.reference' into wip.reference 2018-10-31 16:05:52 -07:00
Natalie Weizenbaum
997c3a7ecd Document the JavaScript API 2018-10-31 16:02:04 -07:00
Jina Anne
6620433c50 redo holy grail layout 2018-10-26 23:37:10 -07:00
Jina Anne
c81d53b5ec refactor breapoints 2018-10-26 23:06:47 -07:00
Jina Anne
7b26d6b684 clean up functions update intended code style in style guide 2018-10-26 21:35:30 -07:00
Natalie Weizenbaum
2b8bf01b7a Properly nest the reference table of contents 2018-10-26 16:04:26 -07:00
Natalie Weizenbaum
7a087e0501 Delete Ruby Sass API docs 2018-10-26 15:24:06 -07:00
Natalie Weizenbaum
c412b8dd4f Document Ruby Sass's CLI 2018-10-26 15:04:43 -07:00
Natalie Weizenbaum
6ad48ae89a Add CLI docs for Dart Sass 2018-10-25 16:46:08 -07:00
Natalie Weizenbaum
dd96c799c3 Document introspection functions 2018-10-24 15:01:43 -07:00
Natalie Weizenbaum
f01aac5d19 Fix broken function links 2018-10-23 17:45:14 -07:00
Natalie Weizenbaum
bfa0d22479 Merge remote-tracking branch 'origin/wip.reference' into wip.reference 2018-10-23 17:30:02 -07:00
Natalie Weizenbaum
0635a3bf61 Add documentation for selector functions 2018-10-23 17:24:13 -07:00
Jina Anne
3f1c2d338d lots of clean up 2018-10-23 15:06:39 -07:00
Natalie Weizenbaum
c7624469b3 Rename function pages to match proposed module names 2018-10-23 13:47:34 -07:00
Natalie Weizenbaum
9ef5ceded1 Add the ability to indent in ERB blocks 2018-10-23 13:42:40 -07:00
Natalie Weizenbaum
f879fcbc97 Add documentation for map functions 2018-10-23 13:01:12 -07:00
Natalie Weizenbaum
dbda46cc63 Share some list examples between function docs and value docs 2018-10-23 12:25:54 -07:00
Natalie Weizenbaum
2207a6042e Add documentation for list functions 2018-10-22 18:26:24 -07:00
Natalie Weizenbaum
6dc51b92e7 Don't autogen CSS for a debug example 2018-10-22 17:40:44 -07:00
Natalie Weizenbaum
0318929b69 Remove a TODO that's been done 2018-10-22 17:28:52 -07:00
Natalie Weizenbaum
5284490b2c Fix markdown in color function docs 2018-10-22 17:16:46 -07:00
Natalie Weizenbaum
05ee8c4582 Document color functions 2018-10-22 17:04:41 -07:00
Natalie Weizenbaum
dbd9a94175 Merge remote-tracking branch 'origin/wip.reference' into wip.reference 2018-10-22 14:25:09 -07:00
Natalie Weizenbaum
fc34fe4b75 Some colors function docs 2018-10-22 14:24:05 -07:00
Jina Anne
f47e8bd912 fix layouts to be DRY 2018-10-22 14:13:05 -07:00
Natalie Weizenbaum
6030761158 Add a helper for writing inline multi-syntax examples (#226)
* Add a helper for writing inline multi-syntax examples

This will be useful for #205.

* Add the ability to add CSS output to the syntax switcher

* Automatically generate CSS for the syntax switcher by default

* Fix most lints

* Fix a specificity bug

* Show SCSS syntax by default

* Fix a couple more lints

* Make the example helper template-engine-agnostic

* Support a "syntax switcher" with a single syntax

This will make it possible to do nice-looking single-syntax code
examples in the reference.

* Remove trailing whitespace
2018-10-22 12:00:45 -07:00
Natalie Weizenbaum
f5b3afc0f9 Update contributing documentation to reflect new processes (#234) 2018-10-22 11:58:42 -07:00
Natalie Weizenbaum
efc113ec86 [WIP] Reference 2018-09-27 16:05:00 -07:00
Miriam Speert Crowley
a0444a2b9c Update community.html.haml (#228)
fixed a few typos!  (or dropped words)
2018-09-19 16:34:25 -07:00
Natalie Weizenbaum
56f97b7751 Merge branch 'example-helper' into wip.reference 2018-08-30 14:45:16 -07:00
Natalie Weizenbaum
f70512c286 Support a "syntax switcher" with a single syntax
This will make it possible to do nice-looking single-syntax code
examples in the reference.
2018-08-30 14:43:38 -07:00
Natalie Weizenbaum
79dc77e9a9 [WIP] reference 2018-08-30 14:37:14 -07:00
Natalie Weizenbaum
8d518df3e3 Enable the syntax switcher outside of the tutorial 2018-08-30 14:36:30 -07:00
Natalie Weizenbaum
078b93a181 Merge branch 'example-helper' into wip.reference 2018-08-30 14:25:57 -07:00
Natalie Weizenbaum
a833c56bf8 Show SCSS syntax by default 2018-08-29 17:59:51 -07:00