Updated to Docsy HEAD

This updates the vendored docsy to https://github.com/google/docsy/tree/1a09abe6d7eaf02e44f79de3eadf8178a3792e81
This commit is contained in:
Ian Lewis
2019-11-13 13:03:16 -08:00
committed by Ian Lewis
parent cf5b8ec088
commit a2b055de52
10291 changed files with 244010 additions and 196136 deletions
+34 -18
View File
@@ -1,34 +1,50 @@
# Docsy
Docsy is a Hugo theme for technical documentation sets, providing simple navigation, site structure, and more.
Docsy is a [Hugo](https://gohugo.io/) theme for technical documentation sets, providing simple navigation, site structure, and more.
You can find an example project that uses Docsy in the [Docsy Example Project repo](https://github.com/google/docsy-example). The Docsy Example Project is hosted at [https://testydocsy.netlify.com/](https://testydocsy.netlify.com/), where you can find detailed theme instructions under **Documentation -> Getting Started**.
This is not an officially supported Google product. This project is actively being maintained.
To use the Docsy theme, you can either:
## Prerequisites
* Copy and edit the example sites repo, which will also give you a skeleton structure for your top-level and documentation sections, or
* Specify the Docsy theme like any other [Hugo theme](https://gohugo.io/themes/installing-and-using-themes/)
when creating or updating your site. This gives you all the theme-y goodness but youll need to specify your own site structure.
The following are basic prerequisites for using Docsy in your site:
This is not an officially supported Google product. This project is currently maintained.
- Install a recent release of the Hugo "extended" version (we recommend version 0.53 or later). If you install from the
[release page](https://github.com/gohugoio/hugo/releases), make sure you download the `_extended` version
which supports SCSS.
## Installation and prerequisites
- Install `PostCSS` so that the site build can create the final CSS assets. You can install it locally by running
the following commands from the root directory of your project:
You need a recent version of Hugo to build sites using this theme (preferably 0.45+). If you install from the [release page](https://github.com/gohugoio/hugo/releases), make sure to get the `extended` Hugo version which supports SCSS. Alternatively, on macOS you can install Hugo via Brew.
```
sudo npm install -D --save autoprefixer
sudo npm install -D --save postcss-cli
```
If you want to do stylesheet changes, you will also need `PostCSS` to create the final assets. You can also install it locally with:
## Example and usage
```
npm install
````
You can find an example project that uses Docsy in the [Docsy Example Project repo](https://github.com/google/docsy-example). The Docsy Example Project is hosted at [https://example.docsy.dev/](https://example.docsy.dev/).
To use a local version of the theme files, clone the repo using:
To use the Docsy theme for your own site:
- (Recommended) Copy the [example project](https://github.com/google/docsy-example),
which includes the Docsy theme as a submodule.
You can customize this pre-configured basic site into your own Docsy themed site.
[Learn more...](https://github.com/google/docsy-example)
- Add Docsy to your existing Hugo site repo's `themes` directory. You can either add Docsy as a Git submodule, or
clone the Docsy theme into your project.
See the [Docsy Getting Started Guide](https://docsy.dev/docs/getting-started/) for
details about the various usage options.
## Documentation
Docsy has its own user guide (using Docsy, of course!) with lots more information about using the theme, which you can find at [https://docsy.dev/](https://docsy.dev/). Alternatively you can use Hugo to generate and serve a local copy of the guide (also useful for testing local theme changes), making sure you have installed all the prerequisites listed above:
```
git clone --recurse-submodules --depth 1 https://github.com/google/docsy.git
cd docsy/userguide/
hugo server --themesDir ../..
```
## Theme documentation
Detailed documentation for this theme is in the Docsy Example Project under **Documentation -> Getting Started**.
The Docsy Example Project is on [GitHub](https://github.com/google/docsy-example) and is hosted at [https://testydocsy.netlify.com/](https://testydocsy.netlify.com/).
Note that you need the `themesDir` flag when running Hugo because the site files are inside the theme repo.
Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

+236 -2
View File
@@ -1,3 +1,237 @@
<?xml version="1.0"?>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 240 240">
<?xml version="1.0" encoding="utf-8"?>
<!-- Generator: Adobe Illustrator 23.0.3, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
viewBox="0 0 500 500" style="enable-background:new 0 0 500 500;" xml:space="preserve">
<g>
<path style="fill:#FFFFFF;" d="M116.8525,421.9722c-5.7041,0-10.3442-4.3127-10.3442-9.6129V88.183
c0-5.3002,4.6401-9.6117,10.3442-9.6117H320.858c3.0347,0,9.3959,0.5498,11.7506,2.6302l0.3545,0.3442l58.905,63.2912
c2.3101,2.491,2.9202,8.4928,2.9202,11.3184v256.2039c0,5.3002-4.6407,9.6129-10.3436,9.6129H116.8525z"/>
<g>
<g>
<g>
<path style="fill:#767676;" d="M384.4445,423.2066H116.852c-6.3839,0-11.5786-4.8658-11.5786-10.8474V88.1831
c0-5.9804,5.1947-10.8461,11.5786-10.8461h204.0062c0.377,0,9.2786,0.0329,12.568,2.9389l0.3947,0.3833l58.9508,63.337
c3.2135,3.4652,3.2514,11.7924,3.2514,12.1593v256.2036C396.0231,418.3408,390.8284,423.2066,384.4445,423.2066z
M116.5079,411.9189c0.0848,0.0278,0.1999,0.0531,0.3441,0.0531h267.5925c0.1442,0,0.2581-0.0253,0.3441-0.0531V156.1556
c-0.0076-0.9033-0.3593-3.7347-0.7034-5.0037l-57.6527-61.9416c-1.4651-0.3176-4.4533-0.6389-5.5742-0.6389H116.852
c-0.143,0-0.2594,0.024-0.3441,0.0531V411.9189z M383.9612,150.7699L383.9612,150.7699L383.9612,150.7699z M327.0321,89.371
v0.0013V89.371z"/>
</g>
</g>
</g>
<g>
<g>
<path style="fill:#5B7FC0;" d="M189.0874,210.1754l0.0012-0.0012c7.7751,0.0012,15.0295,4.1862,18.932,10.9234
c1.9177,3.3159,2.9305,7.1011,2.9293,10.9378c0,5.8394-2.2733,11.3304-6.4032,15.4604
c-4.1288,4.1288-9.6186,6.4032-15.458,6.4032c-5.8394,0-11.328-2.2733-15.458-6.4032s-6.4032-9.6186-6.4056-15.4628
c0.0012-6.025,2.454-11.4897,6.4116-15.4473C177.5953,212.627,183.0601,210.1742,189.0874,210.1754z M197.0804,232.033
c0.0012-1.4042-0.3687-2.7868-1.063-3.9887c-1.4293-2.4684-4.0833-3.9995-6.9299-4.0019c-4.4077,0.0024-7.993,3.5877-7.993,7.993
c0,2.1356,0.832,4.1431,2.3427,5.6539c1.5083,1.5083,3.5159,2.3403,5.6503,2.3415c2.1356,0,4.1443-0.8308,5.6539-2.3403
S197.0816,234.1722,197.0804,232.033z"/>
<path style="opacity:0.3;fill:#FFFFFF;" d="M189.0898,210.176c7.7763,0,15.0283,4.1826,18.926,10.9151
c1.9201,3.3136,2.9377,7.0988,2.9353,10.9462c0.0024,12.0643-9.8065,21.8636-21.8613,21.8613
c-12.0547,0.0024-21.8636-9.8066-21.8612-21.8613c0-6.0285,2.4516-11.4921,6.4116-15.452
C177.5977,212.6276,183.0612,210.176,189.0898,210.176z M197.0839,232.0372c0-1.4078-0.3711-2.7892-1.0702-3.9959
c-1.4269-2.466-4.0797-3.9983-6.924-3.9983c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0024,4.4077,3.5865,7.9918,7.9942,7.9942c2.2027,0,4.2018-0.8978,5.6479-2.3439
C196.1861,236.239,197.0839,234.2399,197.0839,232.0372z"/>
<g>
<defs>
<path id="SVGID_1_" d="M194.7376,237.6875c-1.4461,1.4461-3.4452,2.3439-5.6479,2.3439
c-4.4077-0.0024-7.9918-3.5865-7.9942-7.9942c0.0024-4.4125,3.5937-7.999,7.9942-7.9942c2.8443,0,5.497,1.5323,6.924,3.9983
c0.6991,1.2067,1.0702,2.5881,1.0702,3.9959C197.0839,234.2399,196.1861,236.239,194.7376,237.6875z"/>
</defs>
<clipPath id="SVGID_2_">
<use xlink:href="#SVGID_1_" style="overflow:visible;"/>
</clipPath>
<path style="clip-path:url(#SVGID_2_);fill:#FFFFFF;" d="M190.0704,225.0237c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0011,1.9546,0.7088,3.7452,1.8782,5.1354c-1.7447-1.4674-2.8575-3.663-2.8588-6.116
c0.0024-4.4125,3.5936-7.999,7.9942-7.9942c2.3802-0.0001,4.616,1.0833,6.1218,2.8788
C193.7885,225.7247,191.9774,225.0237,190.0704,225.0237z"/>
<path style="opacity:0.13;clip-path:url(#SVGID_2_);fill:#020202;" d="M190.0704,225.0237
c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942c0.0011,1.9546,0.7088,3.7452,1.8782,5.1354
c-1.7447-1.4674-2.8575-3.663-2.8588-6.116c0.0024-4.4125,3.5936-7.999,7.9942-7.9942c2.3802-0.0001,4.616,1.0833,6.1218,2.8788
C193.7885,225.7247,191.9774,225.0237,190.0704,225.0237z"/>
</g>
<g>
<defs>
<path id="SVGID_3_" d="M189.0898,210.176c7.7763,0,15.0283,4.1826,18.926,10.9151c1.9201,3.3136,2.9377,7.0988,2.9353,10.9462
c0.0024,12.0643-9.8065,21.8636-21.8613,21.8613c-12.0547,0.0024-21.8636-9.8066-21.8612-21.8613
c0-6.0285,2.4516-11.4921,6.4116-15.452C177.5977,212.6276,183.0612,210.176,189.0898,210.176z M197.0839,232.0372
c0-1.4078-0.3711-2.7892-1.0702-3.9959c-1.4269-2.466-4.0797-3.9983-6.924-3.9983c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0024,4.4077,3.5865,7.9918,7.9942,7.9942c2.2027,0,4.2018-0.8978,5.6479-2.3439
C196.1861,236.239,197.0839,234.2399,197.0839,232.0372z"/>
</defs>
<clipPath id="SVGID_4_">
<use xlink:href="#SVGID_3_" style="overflow:visible;"/>
</clipPath>
<path style="clip-path:url(#SVGID_4_);fill:#5B7FC0;" d="M172.6595,215.6045c-3.96,3.96-6.4116,9.4235-6.4116,15.452
c-0.0024,12.0547,9.8066,21.8636,21.8613,21.8612c12.0547,0.0024,21.8636-9.797,21.8613-21.8612
c0.0024-3.8475-1.0151-7.6326-2.9353-10.9462c-3.8977-6.7324-11.1497-10.9151-18.926-10.9151
C182.0806,209.1953,176.6171,211.647,172.6595,215.6045z"/>
</g>
</g>
<rect x="198.8952" y="225.1043" style="fill:#5B7FC0;" width="122.6266" height="13.8671"/>
</g>
<g>
<path style="fill:#D95140;" d="M189.0874,155.7611l0.0012-0.0012c7.7751,0.0012,15.0295,4.1862,18.932,10.9234
c1.9177,3.3159,2.9305,7.1011,2.9293,10.9378c0,5.8394-2.2733,11.3304-6.4032,15.4604c-4.1288,4.1288-9.6186,6.4032-15.458,6.4032
c-5.8394,0-11.328-2.2733-15.458-6.4032s-6.4032-9.6186-6.4056-15.4628c0.0012-6.0249,2.454-11.4897,6.4116-15.4473
C177.5953,158.2128,183.0601,155.7599,189.0874,155.7611z M197.0804,177.6188c0.0012-1.4042-0.3687-2.7868-1.063-3.9887
c-1.4293-2.4684-4.0833-3.9995-6.9299-4.0019c-4.4077,0.0024-7.993,3.5877-7.993,7.993c0,2.1356,0.832,4.1431,2.3427,5.6539
c1.5083,1.5083,3.5159,2.3403,5.6503,2.3415c2.1356,0,4.1443-0.8308,5.6539-2.3403
C196.2508,181.7667,197.0816,179.758,197.0804,177.6188z"/>
<path style="opacity:0.3;fill:#FFFFFF;" d="M189.0898,155.7617c7.7763,0,15.0283,4.1826,18.926,10.9151
c1.9201,3.3135,2.9377,7.0987,2.9353,10.9462c0.0024,12.0643-9.8065,21.8636-21.8613,21.8613
c-12.0547,0.0024-21.8636-9.8066-21.8612-21.8613c0-6.0285,2.4516-11.4921,6.4116-15.452
C177.5977,158.2134,183.0612,155.7617,189.0898,155.7617z M197.0839,177.623c0-1.4078-0.3711-2.7892-1.0702-3.9959
c-1.4269-2.466-4.0797-3.9983-6.924-3.9983c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0024,4.4077,3.5865,7.9918,7.9942,7.9942c2.2027,0,4.2018-0.8978,5.6479-2.3439
C196.1861,181.8248,197.0839,179.8256,197.0839,177.623z"/>
<g>
<defs>
<path id="SVGID_5_" d="M194.7376,183.2733c-1.4461,1.4461-3.4452,2.3439-5.6479,2.3439
c-4.4077-0.0024-7.9918-3.5865-7.9942-7.9942c0.0024-4.4125,3.5937-7.9989,7.9942-7.9942c2.8443,0,5.497,1.5323,6.924,3.9983
c0.6991,1.2067,1.0702,2.5881,1.0702,3.9959C197.0839,179.8256,196.1861,181.8248,194.7376,183.2733z"/>
</defs>
<clipPath id="SVGID_6_">
<use xlink:href="#SVGID_5_" style="overflow:visible;"/>
</clipPath>
<path style="clip-path:url(#SVGID_6_);fill:#FFFFFF;" d="M190.0704,170.6095c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0011,1.9546,0.7088,3.7452,1.8782,5.1354c-1.7447-1.4674-2.8575-3.663-2.8588-6.116c0.0024-4.4125,3.5936-7.999,7.9942-7.9942
c2.3802-0.0001,4.616,1.0833,6.1218,2.8788C193.7885,171.3104,191.9774,170.6095,190.0704,170.6095z"/>
<path style="opacity:0.13;clip-path:url(#SVGID_6_);fill:#020202;" d="M190.0704,170.6095
c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942c0.0011,1.9546,0.7088,3.7452,1.8782,5.1354
c-1.7447-1.4674-2.8575-3.663-2.8588-6.116c0.0024-4.4125,3.5936-7.999,7.9942-7.9942c2.3802-0.0001,4.616,1.0833,6.1218,2.8788
C193.7885,171.3104,191.9774,170.6095,190.0704,170.6095z"/>
</g>
<g>
<defs>
<path id="SVGID_7_" d="M189.0898,155.7617c7.7763,0,15.0283,4.1826,18.926,10.9151c1.9201,3.3135,2.9377,7.0987,2.9353,10.9462
c0.0024,12.0643-9.8065,21.8636-21.8613,21.8613c-12.0547,0.0024-21.8636-9.8066-21.8612-21.8613
c0-6.0285,2.4516-11.4921,6.4116-15.452C177.5977,158.2134,183.0612,155.7617,189.0898,155.7617z M197.0839,177.623
c0-1.4078-0.3711-2.7892-1.0702-3.9959c-1.4269-2.466-4.0797-3.9983-6.924-3.9983c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0024,4.4077,3.5865,7.9918,7.9942,7.9942c2.2027,0,4.2018-0.8978,5.6479-2.3439
C196.1861,181.8248,197.0839,179.8256,197.0839,177.623z"/>
</defs>
<clipPath id="SVGID_8_">
<use xlink:href="#SVGID_7_" style="overflow:visible;"/>
</clipPath>
<path style="clip-path:url(#SVGID_8_);fill:#D95140;" d="M172.6595,161.1903c-3.96,3.96-6.4116,9.4235-6.4116,15.452
c-0.0024,12.0547,9.8066,21.8636,21.8613,21.8613c12.0547,0.0024,21.8636-9.797,21.8613-21.8613
c0.0024-3.8474-1.0151-7.6326-2.9353-10.9462c-3.8977-6.7324-11.1497-10.9151-18.926-10.9151
C182.0806,154.7811,176.6171,157.2327,172.6595,161.1903z"/>
</g>
<rect x="198.8952" y="170.69" style="fill:#D95140;" width="122.6266" height="13.8671"/>
</g>
<g>
<g>
<path style="fill:#56A55C;" d="M189.5379,264.6147l0.0012-0.0012c7.7751,0.0012,15.0294,4.1862,18.932,10.9235
c1.9177,3.3159,2.9305,7.1011,2.9293,10.9378c0,5.8394-2.2733,11.3304-6.4032,15.4604
c-4.1288,4.1288-9.6186,6.4032-15.458,6.4032c-5.8394,0-11.3281-2.2733-15.458-6.4032c-4.13-4.13-6.4032-9.6186-6.4056-15.4628
c0.0012-6.0249,2.454-11.4897,6.4116-15.4472C178.0458,267.0663,183.5105,264.6135,189.5379,264.6147z M197.5309,286.4723
c0.0012-1.4042-0.3687-2.7868-1.063-3.9887c-1.4293-2.4684-4.0833-3.9995-6.9299-4.0019c-4.4077,0.0024-7.993,3.5877-7.993,7.993
c0,2.1356,0.832,4.1431,2.3427,5.6538c1.5083,1.5083,3.5159,2.3403,5.6503,2.3415c2.1356,0,4.1443-0.8308,5.6539-2.3403
C196.7013,290.6202,197.5321,288.6115,197.5309,286.4723z"/>
<path style="opacity:0.3;fill:#FFFFFF;" d="M189.5403,264.6153c7.7763,0,15.0283,4.1826,18.926,10.9151
c1.9201,3.3135,2.9377,7.0987,2.9353,10.9462c0.0024,12.0643-9.8065,21.8636-21.8613,21.8613
c-12.0547,0.0024-21.8636-9.8065-21.8612-21.8613c0-6.0285,2.4516-11.492,6.4116-15.452
C178.0482,267.0669,183.5117,264.6153,189.5403,264.6153z M197.5344,286.4765c0-1.4078-0.3711-2.7892-1.0702-3.9959
c-1.4269-2.466-4.0797-3.9983-6.924-3.9983c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9941
c0.0024,4.4077,3.5865,7.9918,7.9942,7.9942c2.2027,0,4.2018-0.8978,5.6479-2.3439
C196.6366,290.6783,197.5344,288.6792,197.5344,286.4765z"/>
<g>
<defs>
<path id="SVGID_9_" d="M195.1881,292.1268c-1.4461,1.4461-3.4452,2.3439-5.6479,2.3439
c-4.4077-0.0024-7.9918-3.5865-7.9942-7.9942c0.0024-4.4125,3.5937-7.9989,7.9942-7.9941c2.8443,0,5.497,1.5323,6.924,3.9983
c0.6991,1.2067,1.0702,2.5881,1.0702,3.9959C197.5344,288.6792,196.6366,290.6783,195.1881,292.1268z"/>
</defs>
<clipPath id="SVGID_10_">
<use xlink:href="#SVGID_9_" style="overflow:visible;"/>
</clipPath>
<path style="clip-path:url(#SVGID_10_);fill:#FFFFFF;" d="M190.5209,279.463c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9941
c0.0011,1.9547,0.7088,3.7452,1.8782,5.1354c-1.7446-1.4674-2.8575-3.6631-2.8588-6.1161
c0.0024-4.4125,3.5936-7.999,7.9942-7.9941c2.3802-0.0001,4.616,1.0833,6.1218,2.8788
C194.239,280.164,192.4279,279.463,190.5209,279.463z"/>
<path style="opacity:0.13;clip-path:url(#SVGID_10_);fill:#020202;" d="M190.5209,279.463
c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9941c0.0011,1.9547,0.7088,3.7452,1.8782,5.1354
c-1.7446-1.4674-2.8575-3.6631-2.8588-6.1161c0.0024-4.4125,3.5936-7.999,7.9942-7.9941
c2.3802-0.0001,4.616,1.0833,6.1218,2.8788C194.239,280.164,192.4279,279.463,190.5209,279.463z"/>
</g>
<g>
<defs>
<path id="SVGID_11_" d="M189.5403,264.6153c7.7763,0,15.0283,4.1826,18.926,10.9151
c1.9201,3.3135,2.9377,7.0987,2.9353,10.9462c0.0024,12.0643-9.8065,21.8636-21.8613,21.8613
c-12.0547,0.0024-21.8636-9.8065-21.8612-21.8613c0-6.0285,2.4516-11.492,6.4116-15.452
C178.0482,267.0669,183.5117,264.6153,189.5403,264.6153z M197.5344,286.4765c0-1.4078-0.3711-2.7892-1.0702-3.9959
c-1.4269-2.466-4.0797-3.9983-6.924-3.9983c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9941
c0.0024,4.4077,3.5865,7.9918,7.9942,7.9942c2.2027,0,4.2018-0.8978,5.6479-2.3439
C196.6366,290.6783,197.5344,288.6792,197.5344,286.4765z"/>
</defs>
<clipPath id="SVGID_12_">
<use xlink:href="#SVGID_11_" style="overflow:visible;"/>
</clipPath>
<path style="clip-path:url(#SVGID_12_);fill:#56A55C;" d="M173.11,270.0439c-3.96,3.96-6.4116,9.4235-6.4116,15.452
c-0.0024,12.0547,9.8066,21.8636,21.8613,21.8613c12.0547,0.0024,21.8636-9.797,21.8613-21.8613
c0.0024-3.8474-1.0151-7.6326-2.9353-10.9462c-3.8977-6.7325-11.1497-10.9151-18.926-10.9151
C182.5311,263.6346,177.0676,266.0863,173.11,270.0439z"/>
</g>
</g>
<rect x="199.3456" y="279.5436" style="fill:#56A55C;" width="122.6266" height="13.8671"/>
</g>
<g>
<g>
<path style="fill:#F1BC42;" d="M189.0874,318.7208l0.0012-0.0012c7.7751,0.0012,15.0295,4.1862,18.932,10.9234
c1.9177,3.3159,2.9305,7.1011,2.9293,10.9378c0,5.8394-2.2733,11.3305-6.4032,15.4604
c-4.1288,4.1288-9.6186,6.4032-15.458,6.4032c-5.8394,0-11.328-2.2733-15.458-6.4032c-4.13-4.1299-6.4032-9.6186-6.4056-15.4628
c0.0012-6.025,2.454-11.4897,6.4116-15.4472C177.5953,321.1724,183.0601,318.7196,189.0874,318.7208z M197.0804,340.5784
c0.0012-1.4042-0.3687-2.7868-1.063-3.9887c-1.4293-2.4684-4.0833-3.9995-6.9299-4.0019c-4.4077,0.0024-7.993,3.5877-7.993,7.993
c0,2.1356,0.832,4.1431,2.3427,5.6539c1.5083,1.5083,3.5159,2.3403,5.6503,2.3415c2.1356,0,4.1443-0.8308,5.6539-2.3403
S197.0816,342.7176,197.0804,340.5784z"/>
<path style="opacity:0.3;fill:#FFFFFF;" d="M189.0898,318.7214c7.7763,0,15.0283,4.1826,18.926,10.915
c1.9201,3.3136,2.9377,7.0988,2.9353,10.9462c0.0024,12.0643-9.8065,21.8636-21.8613,21.8612
c-12.0547,0.0024-21.8636-9.8065-21.8612-21.8612c0-6.0285,2.4516-11.4921,6.4116-15.452
C177.5977,321.173,183.0612,318.7214,189.0898,318.7214z M197.0839,340.5826c0-1.4078-0.3711-2.7892-1.0702-3.9959
c-1.4269-2.466-4.0797-3.9983-6.924-3.9983c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0024,4.4077,3.5865,7.9918,7.9942,7.9942c2.2027,0,4.2018-0.8978,5.6479-2.3439
C196.1861,344.7844,197.0839,342.7853,197.0839,340.5826z"/>
<g>
<defs>
<path id="SVGID_13_" d="M194.7376,346.2329c-1.4461,1.4461-3.4452,2.3439-5.6479,2.3439
c-4.4077-0.0024-7.9918-3.5865-7.9942-7.9942c0.0024-4.4125,3.5937-7.999,7.9942-7.9942c2.8443,0,5.497,1.5323,6.924,3.9983
c0.6991,1.2067,1.0702,2.5881,1.0702,3.9959C197.0839,342.7853,196.1861,344.7844,194.7376,346.2329z"/>
</defs>
<clipPath id="SVGID_14_">
<use xlink:href="#SVGID_13_" style="overflow:visible;"/>
</clipPath>
<path style="clip-path:url(#SVGID_14_);fill:#FFFFFF;" d="M190.0704,333.5691c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0011,1.9547,0.7088,3.7452,1.8782,5.1354c-1.7447-1.4674-2.8575-3.6631-2.8588-6.1161
c0.0024-4.4125,3.5936-7.999,7.9942-7.9942c2.3802-0.0001,4.616,1.0834,6.1218,2.8788
C193.7885,334.2701,191.9774,333.5691,190.0704,333.5691z"/>
<path style="opacity:0.13;clip-path:url(#SVGID_14_);fill:#020202;" d="M190.0704,333.5691
c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942c0.0011,1.9547,0.7088,3.7452,1.8782,5.1354
c-1.7447-1.4674-2.8575-3.6631-2.8588-6.1161c0.0024-4.4125,3.5936-7.999,7.9942-7.9942
c2.3802-0.0001,4.616,1.0834,6.1218,2.8788C193.7885,334.2701,191.9774,333.5691,190.0704,333.5691z"/>
</g>
<g>
<defs>
<path id="SVGID_15_" d="M189.0898,318.7214c7.7763,0,15.0283,4.1826,18.926,10.915c1.9201,3.3136,2.9377,7.0988,2.9353,10.9462
c0.0024,12.0643-9.8065,21.8636-21.8613,21.8612c-12.0547,0.0024-21.8636-9.8065-21.8612-21.8612
c0-6.0285,2.4516-11.4921,6.4116-15.452C177.5977,321.173,183.0612,318.7214,189.0898,318.7214z M197.0839,340.5826
c0-1.4078-0.3711-2.7892-1.0702-3.9959c-1.4269-2.466-4.0797-3.9983-6.924-3.9983c-4.4005-0.0048-7.9918,3.5817-7.9942,7.9942
c0.0024,4.4077,3.5865,7.9918,7.9942,7.9942c2.2027,0,4.2018-0.8978,5.6479-2.3439
C196.1861,344.7844,197.0839,342.7853,197.0839,340.5826z"/>
</defs>
<clipPath id="SVGID_16_">
<use xlink:href="#SVGID_15_" style="overflow:visible;"/>
</clipPath>
<path style="clip-path:url(#SVGID_16_);fill:#F1BC42;" d="M172.6595,324.15c-3.96,3.96-6.4116,9.4235-6.4116,15.452
c-0.0024,12.0547,9.8066,21.8636,21.8613,21.8612c12.0547,0.0024,21.8636-9.797,21.8613-21.8612
c0.0024-3.8474-1.0151-7.6327-2.9353-10.9462c-3.8977-6.7324-11.1497-10.9151-18.926-10.9151
C182.0806,317.7407,176.6171,320.1924,172.6595,324.15z"/>
</g>
</g>
<rect x="198.8952" y="333.6497" style="fill:#F1BC42;" width="122.6266" height="13.8671"/>
</g>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 92 B

After

Width:  |  Height:  |  Size: 16 KiB

+49
View File
@@ -0,0 +1,49 @@
/*
* Copyright 2018 Google LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
(function ($) {
'use strict';
// Headers' anchor link that shows on hover
$(function () {
// append anchor links to headings in markdown.
var article = document.getElementsByTagName('main')[0];
if (!article) {
return;
}
var headings = article.querySelectorAll('h1, h2, h3, h4, h5, h6');
headings.forEach(function (heading) {
if (heading.id) {
var a = document.createElement('a');
// set visibility: hidden, not display: none to avoid layout change
a.style.visibility = 'hidden';
// [a11y] hide this from screen readers, etc..
a.setAttribute('aria-hidden', 'true');
// material insert_link icon in svg format
a.innerHTML = ' <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="24" height="24" viewBox="0 0 24 24"><path d="M0 0h24v24H0z" fill="none"/><path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"/></svg>';
a.href = '#' + heading.id;
heading.insertAdjacentElement('beforeend', a);
heading.addEventListener('mouseenter', function () {
a.style.visibility = 'initial';
});
heading.addEventListener('mouseleave', function () {
a.style.visibility = 'hidden';
});
}
});
});
}(jQuery));
+29 -1
View File
@@ -77,6 +77,34 @@
@include td-box-height-modifiers(".td-box");
// Styling for section boxes
.td-box {
.row.section {
padding-left: 5rem;
padding-right: 5rem;
flex-direction: column;
> table {
@extend .table-striped;
@extend .table-responsive;
@extend .table;
}
}
.row {
padding-left: 5rem;
padding-right: 5rem;
flex-direction: row;
}
}
// Styling for community page link boxes
.td-box.linkbox {
padding: 5rem;
}
// This allows "painting by numbers"
@for $i from 1 through length($td-box-colors) {
$c: nth($td-box-colors, $i);
@@ -96,4 +124,4 @@
@each $color, $value in $grays {
@include box-variant(".td-box", $color, $value);
}
}
+3 -2
View File
@@ -20,11 +20,12 @@
}
// Inline code
p code, li > code {
p code, li > code, table code {
color: inherit;
padding: 0.2em 0.4em;
margin: 0;
font-size: 85%;
word-break: normal;
background-color: rgba($black, 0.05);
border-radius: $border-radius;
@@ -50,4 +51,4 @@
border: 0;
}
}
}
}
+18
View File
@@ -0,0 +1,18 @@
.pageinfo {
font-weight: $font-weight-medium;
background: $gray-100;
color: inherit;
border-radius: 0;
margin: 2rem;
padding: 1.5rem;
padding-bottom: 0.5rem;
@each $color, $value in $theme-colors {
&-#{$color} {
border-style: solid;
border-color: $value;
}
}
}
+1 -1
View File
@@ -13,7 +13,7 @@ $enable-shadows: true;
// Theme flags.
$td-enable-google-fonts: true;
$td-enable-google-fonts: true !default;
// Theme colors
+6 -4
View File
@@ -5,9 +5,9 @@
@import "../vendor/bootstrap/scss/bootstrap";
@import "../vendor/Font-Awesome//web-fonts-with-css/scss/fontawesome.scss";
@import "../vendor/Font-Awesome//web-fonts-with-css/scss/fa-solid.scss";
@import "../vendor/Font-Awesome//web-fonts-with-css/scss/fa-brands.scss";
@import "../vendor/Font-Awesome/scss/fontawesome.scss";
@import "../vendor/Font-Awesome/scss/solid.scss";
@import "../vendor/Font-Awesome/scss/brands.scss";
@import "support/utilities";
@import "colors";
@@ -24,6 +24,8 @@
@import "search";
@import "main-container";
@import "blocks/blocks";
@import "section-index";
@import "pageinfo";
@if $td-enable-google-fonts {
@import url($web-font-path);
@@ -55,4 +57,4 @@ footer {
}
}
@import "styles_project";
@import "styles_project";
@@ -0,0 +1,18 @@
.section-index {
.entry {
padding: .75rem;
}
h5 {
margin-bottom: 0;
a {
font-weight: 700;
}
}
p {
margin-top: 0;
}
}
@@ -13,10 +13,6 @@
@if $underline {
text-decoration: underline;
}
@include hover-focus {
color: $hover-color;
}
}
}
@@ -46,4 +42,4 @@
@include optional-at-root(":-ms-input-placeholder") {
@content;
}
}
}
@@ -1,29 +0,0 @@
### Describe the problem
<!--- What happened? What are you seeing? How did you arrive here? -->
### What did you expect?
<!--- How would you like this to work instead? -->
### What version and implementation are you using?
Version: <!--- Give us the version number here -->
Browser and version: <!--- If applicable give us the browser specs -->
- [ ] SVG with JS
- [ ] Web Fonts with CSS
- [ ] SVG Sprites
- [ ] On the Desktop
### Reproducible test case
<!--- Insert a URL to your test case - use codepen.io, jsfiddle.net, jsbin.com, codesandbox.io, or whatever -->
<!--- Describe any details about the test case that we need to know like "whatever you do, don't click the red button" -->
### Bug report checklist
- [ ] I have filled out as much of the above information as I can
- [ ] I have included a test case because my odds go _way_ up that the team can fix this when I do
- [ ] I have [searched for existing issues](https://github.com/FortAwesome/Font-Awesome/issues) and to the best of my knowledge this is not a duplicate
@@ -1,25 +0,0 @@
### Describe the problem you'd like to see solved or task you'd like to see made easier
<!--- What steps or tasks are you trying to complete along the way? -->
### Is this in relation to an existing part of Font Awesome or something new?
<!--- If so, what part of Font Awesome? -->
### What is 1 thing that we can do when building this feature that will guarantee that it is awesome?
<!--- e.g. make finding icons while I'm designing super fast -->
### Why would other Font Awesome users care about this?
<!--- e.g. because everyone wants icons that fly -->
### On a scale of 1 (sometime in the future) to 10 (absolutely right now), how soon would you recommend we make this feature?
<!--- e.g. 5 - "while we're young" -->
### Feature request checklist
- [ ] This is a single feature (i.e. not a re-write of all of Font Awesome)
- [ ] The title starts with "Feature request: " and is followed by a clear feature name (Ex: `Feature request: moar cowbell`)
- [ ] I have [searched for existing issues](https://github.com/FortAwesome/Font-Awesome-Pro/issues) and to the best of my knowledge this is not a duplicate
@@ -1,15 +0,0 @@
### What can it be used for?
<!--- describe how this could be used / the use case for this icon -->
### Example image (optional)
<!--- insert the example image here if necessary -->
### Icon request checklist
- [ ] This is a single icon or matched pair (Ex: `lock` / `unlock`)
- [ ] The title starts with "Icon request: " and is followed by the requested icon name (Ex: `Icon request: magical-unicorn`)
- [ ] I have [searched for existing issues](https://github.com/FortAwesome/Font-Awesome/issues) and to the best of my knowledge this is not a duplicate
- [ ] I have included at least one example image if it could be helpful (optional)
- [ ] The request is for a concrete object (it's harder to make an icon to represent happiness, it's easier to make a smiley face. ☺)
@@ -1,6 +0,0 @@
<!--- WARNING Pull Requests made to this repository cannot be merged -->
I understand that:
- [ ] I'm submitting this PR for reference only. It shows an example of what I'd like to see changed but
I understand that it will not be merged and I will not be listed as a contributor on this project.
+301 -1
View File
@@ -2,12 +2,312 @@
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
The format is based on [Keep a Changelog](https://keepachangelog.com/) and this project adheres to [Semantic Versioning](https://semver.org/).
**Note that references to the Font-Awesome-Pro repository refer to a GitHub
repository that is by invitation only. You will get a 404 - Not Found if you do
not have access**
## [5.10.1](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.10.1) - 2019-08-02
### Added
* README file in the otfs/ directory to help direct folks to documentation for the new Duotone OTF file
### Changed
* A lot of visual improvements and consistency fixes to many of the new Duotone icons
* The fa-swap-opacity class now works with parent containers where Duotone icons as children
### Fixed
* Duotone SCSS files were not being correctly compiled with the Dart-Sass tool
* Font Awesome logo was not appearing in desktop application in font pickers
---
## [5.10.0](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.10.0) - 2019-07-29
### Added
* Duotone icons style added with over 1,600 new icons
* New conflict detection script to help identify conflicting versions of Font Awesome (js/conflict-detection.js)
* Icons border-center-v and border-center-h
* New brand icon for cotton-bureau
### Changed
* Updated version 4 shim to more accurately match sort-alpha-desc, sort-amount-desc, sort-numeric-desc
### Fixed
* Icon sort-amount-down-alt incorrectly matching sort-amount-down
* Icon border-outer icon missing inner grid shapes
---
## [5.9.0](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.9.0) - 2019-06-04
**Minor version upgrade notice: there are some backward-incompatible changes to this release. See the
[UPGRADING.md guide](https://github.com/FortAwesome/Font-Awesome/blob/master/UPGRADING.md) for more
information.**
### Added
* An assortment of voted icons, updated icons, and new icons
* New icons and updates to the text editor category
* A flipped version of the phone and phone-alt icon
### Changed
* Removed the nintendo-switch icon by request of Nintendo
* Sorted out the sort icons FortAwesome/Font-Awesome#9464 FortAwesome/Font-Awesome#9419 FortAwesome/Font-Awesome-Pro#915
* De-crevassed the brain icons
### Fixed
* Proportions corrected on facebook-messenger brand icon
---
## [5.8.2](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.8.2) - 2019-05-07
### Added
* New brand icon stackpath
### Changed
* Updated redhat, mailchimp brand icons
* Updated Facebook brand icons in accordance with https://facebookbrand.com (facebook, facebook-f, facebook-square)
* Updated Git brand icons (git, git-square, git-alt)
* Removing the "at" character to prevent overlap with the at icon
### Fixed
* Missing version for the route icon FortAwesome/Font-Awesome#13804
* Corrected the orientation of radiation and radiation-alt icons
* Alignment fixed for check-double
* Moved the notch into the correct location for sim-card
* Allow the role attribute to be specified FortAwesome/Font-Awesome#14791
* Prevent IE11 CSS selector error from crashing SVG with JS execution
---
## [5.8.1](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.8.1) - 2019-03-21
### Fixed
* Correct the baseline alignment of the linkedin-in brand icon
---
## [5.8.0](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.8.0) - 2019-03-20
**Minor version upgrade notice: there are some backward-incompatible changes to this release. See the
[UPGRADING.md guide](https://github.com/FortAwesome/Font-Awesome/blob/master/UPGRADING.md) for more
information.**
### Added
* New sponsored icon wave-square
* Adding new mutateApproach configuration which can force SVG with JS to render synchronously
* Adding a round of top requested brand icons
### Changed
* Updating search terms and adding new categories
* Removing descender-based CSS from the .fa-icon Sass mixin
* Removed title elements from SVG sprites
### Fixed
* Fixing several icons such as spinner-third that had incorrect widths
* Allow Sass setting for `font-display` to be changed
* Missing dots in the flower icons
* Support strict math compatibility for Less
* Support fa-flip-both in the SVG with JS version
---
## [5.7.2](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.7.2) - 2019-02-12
### Fixed
* Vertical alignment issues using OTF and TTF files in desktop applications that differ from previous
Font Awesome versions (< 5.7.0)
---
## [5.7.1](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.7.1) - 2019-02-01
### Fixed
* The @fortawesome/fontawesome-pro package had a corrupted SVG webfont file for the solid style
* IE11 error reporting Promise as undefined or finally() not a function
* The cheese has been moved on top of the patty for cheeseburger
---
## [5.7.0](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.7.0) - 2019-01-28
**Minor version upgrade notice: there are some backward-incompatible changes to this release. See the
[UPGRADING.md guide](https://github.com/FortAwesome/Font-Awesome/blob/master/UPGRADING.md) for more
information.**
### Added
* New Food category
* More Medical icons
* More icons from the leaderboard
* Added tasks-alt
* New CSS class fa-flip-both that applies fa-flip-horizontal and fa-flip-vertical together
* CSS now defaults to font-display: auto
* Sass and Less files contain a variable that can be changed to alter the font-display value
### Changed
* Updated slack brand icon
* Reverted calendar-alt to previous design before 5.6.0
### Fixed
* Safari fails to process pseudo elements if the font-weight is "normal"
* Renamed internal method to keep from confusing rJS FortAwesome/Font-Awesome#14461
* Corrected font weights in TTF files FortAwesome/Font-Awesome#13320
* XCode now correctly displays different styles when using TTF files
* Support for Turbolinks without modifying the dom.watch() call FortAwesome/Font-Awesome#12709
* Add focusable=false for SVG elements to prevent IE11 double-focus bug FortAwesome/Font-Awesome#13155
---
## [5.6.3](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.6.3) - 2018-12-20
### Changed
* Revising fire icon and adding alternative fire icon
* Updating fedora brand icon
---
## [5.6.1](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.6.1) - 2018-12-12
### Fixed
* NPM JavaScript icon packages no longer include ES6 expressions in non-ES6 files
FortAwesome/Font-Awesome#14382, FortAwesome/Font-Awesome#14380, FortAwesome/Font-Awesome-Pro#1286
* Removed extra point in the light style of exclamation-triangle
* Correct a typo in the license files
---
## [5.6.0](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.6.0) - 2018-12-07
**Minor version upgrade notice: there are some backward-incompatible changes to this release. See the
[UPGRADING.md guide](https://github.com/FortAwesome/Font-Awesome/blob/master/UPGRADING.md) for more
information.**
### Added
* Holiday category
* Winter category
* A nice selection of the top requested icons from the Font Awesome Leaderboard
* Sponsored icon horse-head
* Brand icons adobe, artstation, atlassian, centos, confluence, dhl, diaspora,
fedex, fedora, figma, intercom, invision, jira, mendeley, raspberry-pi,
redhat, sketch, sourcetree, suse, ubuntu, ups, usps, and yarn
* The Canadian Maple Leaf (Aboot time, eh. You hosers.)
### Changed
* Added more icons to Buildings, Hands, Spinners, Users & People, and Vehicles categories
* Added indicators whether an icon was added to Font Awesome through community voting
### Fixed
* Missing metadata for holly-berry
---
## [5.5.0](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.5.0) - 2018-11-02
### Added
* Politics category
* Weather category (volume 1 and 2)
* Brand icon reacteurope
* Sponsorship of briefcase by WorkRails
### Fixed
* Alignment centered for larger icons when using the CSS stacks feature
---
## [5.4.2](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.4.2) - 2018-10-25
### Added
* Brand icon think-peaks
### Changed
* Updated rocketchat brand icon
* Adding vr-cardboard and d-and-d-beyond to Free version
* Replacing rendact with wpressr brand icon
* Changing the version 4 shim for commenting icon to solid style to better match version 4
### Fixed
* Path issues with tombstone-alt icon in Regular and Light styles
---
## [5.4.1](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.4.1) - 2018-10-10
### Fixed
* Separate wand and wand-magic into unique icons
* Corrected the alignment of linkedin-in
* Renamed categories "Holiday" to "Halloween" and "Seasonal" to "Autumn"
---
## [5.4.0](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.4.0) - 2018-10-08
### Added
* New Tabletop Gaming, Holiday, Seasonal category
* 7 tabletop gaming brands (acquisitions-incorporated, critical-role, d-and-d, d-and-d-beyond, fantasy-flight-games, penny-arcade, wizards-of-the-coast)
* 25 new animals (and all of them are real you Disbelievers)
* Sponsorship of volume-mute by Pulse-Eight
* creative-commons-zero added to Free version
* DEV brand icon
* Search terms "positive" and "negative" added to applicable icons
* Sponsorship of chess-knight by Inspira bvba
* Sponsorship of blender-phone by Joe Emison
* Icons chair, chair-office, file-csv, hammer, head-side, head-vr, house-damage, hryvnia, network-wired, running, slash, user-injured, and vr-cardboard
### Changed
* Using masks with SVG and JavaScript now use nanoid generated IDs instead of a simple counter
* Updated speakap brand icon
* Revised menorah icon and added hanukiah
### Fixed
* Slight distortion in book-heart
* Bad search terms for folder icon
* Set license for @fortawesome/free-brands-svg-icons NPM package
---
## [5.3.1](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.3.1) - 2018-08-28
### Changed
* Updating icons in the Status category
### Fixed
* sponsors.yml listed icon prayer instead of pray
* Removed Pro icons that accidentally made it into Free
---
## [5.3.0](https://github.com/FortAwesome/Font-Awesome/releases/tag/5.3.0) - 2018-08-27
### Added
* New Religion, and Marketing category
* New icons in the Mathematics, and Business category
* New stats for signal, volume, and wifi icons
* New brand icon for the-red-yeti and alipay
### Changed
* Adding ethereum to Currency category
* Adding bitcoin and btc to Payments & Shopping
### Fixed
* Incorrect name for layer-minus and layer-plus in sponsors.yml
* Reversing route-highway and route-interstate
* Correct version identifier in OTF and web font files
* CSS keyframe names are not minified (and renamed) to prevent conflict with user or app specific names
* Sass placeholder selector added for %fa-icon to fix CSS precendence issue with font-weight
---
## [5.2.0](https://github.com/FortAwesome/Font-Awesome-Pro/releases/tag/5.2.0) - 2018-07-23
### Added
* New education and automotive categories
* More icons in the medical and maps categories
* Top requested brands ello, hackerrank, kaggle, markdown, neos, and zhihu
---
## [5.1.1](https://github.com/FortAwesome/Font-Awesome-Pro/releases/tag/5.1.1) - 2018-07-17
### Added
+4 -4
View File
@@ -3,14 +3,14 @@ Font Awesome Free License
Font Awesome Free is free, open source, and GPL friendly. You can use it for
commercial projects, open source projects, or really almost whatever you want.
Full Font Awesome Free license: https://fontawesome.com/license.
Full Font Awesome Free license: https://fontawesome.com/license/free.
# Icons: CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)
In the Font Awesome Free download, the CC BY 4.0 license applies to all icons
packaged as SVG and JS file types.
# Fonts: SIL OFL 1.1 License (https://scripts.sil.org/OFL)
In the Font Awesome Free download, the SIL OLF license applies to all icons
In the Font Awesome Free download, the SIL OFL license applies to all icons
packaged as web and desktop font files.
# Code: MIT License (https://opensource.org/licenses/MIT)
@@ -18,13 +18,13 @@ In the Font Awesome Free download, the MIT license applies to all non-font and
non-icon files.
# Attribution
Attribution is required by MIT, SIL OLF, and CC BY licenses. Downloaded Font
Attribution is required by MIT, SIL OFL, and CC BY licenses. Downloaded Font
Awesome Free files already contain embedded comments with sufficient
attribution, so you shouldn't need to do anything additional when using these
files normally.
We've kept attribution comments terse, so we ask that you do not actively work
to remove them from files, especially code. They're a great way for folks to
to remove them from files, especially code. They're a great way for folks to
learn about Font Awesome.
# Brand Icons
+5 -2
View File
@@ -101,7 +101,7 @@ we deviate from normal SemVer in the following ways:**
write clear upgrading instructions in UPGRADING.md
* A `minor` or `patch` release will never remove icons
* Bug fixes will be addressed as `patch` releases unless they include backward
incompability then they will be `minor` releases
incompatibility then they will be `minor` releases
## License
@@ -125,11 +125,14 @@ to remove them from files, especially code. They're a great way for folks to
learn about Font Awesome.
## Team
* [Dave Gandy](https://github.com/davegandy)
* [Travis Chase](https://github.com/supercodepoet)
* [Rob Madole](https://github.com/robmadole)
* [Brian Talbot](https://github.com/talbs)
* [Jory Raphael](https://github.com/sensibleworld)
* [Mike Wilkerson](https://github.com/mlwilkerson)
* [Trevor Chase](https://github.com/trevorchase)
* [Jason Lundien](https://github.com/jasonlundien)
* [Jason Otero](https://github.com/deathnfudge)
* [Edward Emanuel](https://github.com/ej2)
* [Geremia Taglialatela](https://github.com/tagliala)
+234 -1
View File
@@ -6,6 +6,233 @@ This guide is useful to figure out what you need to do between breaking changes.
As always, [submit issues](https://github.com/FortAwesome/Font-Awesome/issues/new) that you run into with this guide or with these upgrades to us.
---
## 5.10.0 to 5.10.1
The Sass function `fa-content-secondary` which was part of the `duotone.scss`
file has been removed due to its inconsistent behavior in different versions of
Sass pre-processors. Specifically [`node-sass`](https://github.com/sass/node-sass) and
[`sass`](https://github.com/sass/dart-sass) didn't produce the same output.
---
## 5.9.0 to 5.10.0
The following icon shims have been changed to better match the original version 4 icon:
* sort-alpha-desc
* sort-amount-desc
* sort-numeric-desc
---
## 5.8.2 to 5.9.0
The nintendo-switch icon has been removed by legal request of Nintendo of America Inc.
Font Awesome is no longer able to provide icons related to Nintendo, their
gaming consoles, accessories, or games.
---
## 5.8.1 to 5.8.2
There are no breaking changes in this version upgrade.
---
## 5.8.0 to 5.8.1
There are no breaking changes in this version upgrade.
---
## 5.7.x to 5.8.0
### Removing title elements from SVG sprites
Since the initial release of version 5, all the way back to 5.0.0 actually,
we've included `<title>` elements in the SVG sprites.
In https://github.com/FortAwesome/Font-Awesome/issues/14595 a discussion
outlines that this practice actually prevents normal efforts to make these
sprites accessible according to web accessibility standards.
If you are using sprites please refer to [our documentation on accessibility with Font Awesome](https://fontawesome.com/how-to-use/on-the-web/other-topics/accessibility).
### Removing vertical-align from the .fa-icon Sass mixin
Font Awesome has supported Sass and Less CSS pre-processors for a long time.
The version 5 `.fa-icon` mixin which is present in `scss/_mixins.scss`
previously included `vertical-align` which was incorrectly shifting icons.
If you have used this mixin in your own Sass files you will need to check the
alignment of those icons after upgrading to 5.8.0.
---
## 5.7.1 to 5.7.2
There are no breaking changes in this version upgrade.
---
## 5.7.0 to 5.7.1
The cheeseburger icon incorrectly placed the cheese _under_ the patty. This is unacceptable and we've fixed it.
---
## 5.6.x to 5.7.0
### OTF and TTF files
The PostScript name has been changed from `FontAwesome5ProSolid` to `FontAwesome5Pro-Solid`. This was done to be more compatible with tooling such as XCode.
We've also update the `Version` specifier. Font files only support a MAJOR and MINOR version number so we have modifed our schema. For example, version 5.7.0 of Font Awesome is reflected as 329.472 in the individual font files.
### Icon changes
The calendar-alt icon has been reverted back to the previous design in versions <= 5.6.0.
---
## 5.6.x to 5.6.3
The fire icon has been reverted back to the previous design in versions <= 5.5.0.
We have moved the redesigned icon to fire-alt.
---
## 5.6.0 to 5.6.1
There are no breaking changes in this version upgrade.
---
## 5.5.0 to 5.6.0
In this release we've taken time to re-organize the directory structure to
prevent redundancy and improve findability.
### Directory structure changes
| Old path | New path |
|-----------------------------------|-------------|
| advanced-options/metadata | metadata |
| advanced-options/raw-svg | svgs |
| advanced-options/svg-sprites | sprites |
| advanced-options/use-with-node-js | js-packages |
| svg-with-js/js | js |
| svg-with-js/css | css |
| use-on-desktop | otfs |
| web-fonts-with-css/css | css |
| web-fonts-with-css/less | less |
| web-fonts-with-css/scss | scss |
| web-fonts-with-css/webfonts | webfonts |
---
## 5.4.x to 5.5.0
There are no breaking changes in this version upgrade.
---
## 5.4.0 to 5.4.1
Categories were renamed from:
* Holiday to Halloween
* Seasonal to Autumn
The "wand" icon in version 5.4.0 matched the "wand-magic" icon. The magical
sparkles have been removed for "wand". If you were relying on this decoration
in your design switch to "wand-magic" to bring the magic back.
---
## 5.3.x to 5.4.0
There are no breaking changes in this version upgrade.
---
## 5.3.0 to 5.3.1
The following Pro-only icons were removed from Font Awesome Free as of 5.3.1:
* abacus
* calculator-alt
* empty-set
* function
* integral
* intersection
* lambda
* omega
* pi
* sigma
* signal-alt
* signal-alt-slash
* signal-slash
* square-root
* tally
* theta
* tilde
* union
* value-absolute
* volume
* volume-down
* volume-slash
* wifi-slash
These icons were unintentionally included in 5.3.0.
---
## 5.x.x to 5.3.0
Sass mixin syntax has been updated to address a bug.
Use `@extend %fa-icon` to correctly maintain CSS order in output files.
~~Old way:~~
```
.twitter {
@include fa-icon; /* incorrect */
@extend .fab;
&:before {
content: fa-content($fa-var-twitter);
}
}
```
New way:
```
.twitter {
@extend %fa-icon; /* correct */
@extend .fab;
&:before {
content: fa-content($fa-var-twitter);
}
}
```
---
## 5.1.x to 5.2.x
There are no breaking changes in this version upgrade.
---
## 5.1.0 to 5.1.1
Less and Sass files incorrectly contained the "fa-" prefix for style files.
@@ -26,6 +253,8 @@ correct the names in your builds.
| scss/fa-light.scss | scss/light.scss |
| scss/fa-brands.scss | scss/brands.scss |
---
## 5.0.x to 5.1.0
### New packages available for browser-only integration
@@ -50,7 +279,7 @@ account](https://fontawesome.com/account/services).
The following packages have been renamed as part of 5.1.0 of Font Awesome.
_All packages are in the [@fortawesome NPM scope](https://www.npmjs.com/search?q=scope:fortawesome&page=1&ranking=optimal)_
_All packages are in the [@fortawesome NPM scope](https://www.npmjs.com/search?q=scope:fortawesome&ranking=optimal)_
| Old package(1) | New package |
|---------------------------|------------------------|
@@ -143,10 +372,14 @@ rollup({
})
```
---
## 5.0.11 to 5.0.12
Due to a collision with the "r" glyph the R Project brand icon has been renamed to `r-project`.
---
## 5.0.x to 5.0.6
### SVG Attribute was changed from data-fa-processed to data-fa-i2svg
File diff suppressed because it is too large Load Diff

Some files were not shown because too many files have changed in this diff Show More