Documentation for BootStrap

[GladWinIsrael]

Description

A brief overview about BootStrap for new comers

Motivation & Context

Type of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• [x ] Refactoring (non-breaking change)
• Breaking change (fix or feature that would change existing functionality)

Checklist

• I have read the contributing guidelines
• My code follows the code style of the project (using npm run lint)
• [ x] My change introduces changes to the documentation
• [x ] I have updated the documentation accordingly
• [x ] I have added tests to cover my changes
• All new and existing tests passed

Live previews

• https://deploy-preview-{your_pr_number}--twbs-bootstrap.netlify.app/

Related issues

[GladWinIsrael]

a document about BootStrap

[julien-deramond]

@GladWinIsrael There is an issue with your PR:

Please rebase it or change the configuration of the PR so that we can see your changes and not 606 commits.

[mahilanmjd]

ɪ ʜᴀᴠᴇ ʀᴇᴄɪᴇᴠᴇᴅ yᴏᴜʀ ʙᴏᴏᴛꜱᴛʀᴀᴩ ᴅᴏᴄᴜᴍᴇɴᴛᴀᴛɪᴏɴ ɢɪᴛʜᴜʙ ᴄᴀɴ ɪ ɢᴇᴛ ᴛʜᴇ ᴅᴇᴍᴏ ꜰʀᴏᴍ yᴏᴜ ?

…

On Sun, 16 Apr 2023, 3:50 pm GladIsrael, ***@***.***> wrote: Description A brief overview about BootStrap for new comers Motivation & Context Type of changes - Bug fix (non-breaking change which fixes an issue) - New feature (non-breaking change which adds functionality) - [x ] Refactoring (non-breaking change) - Breaking change (fix or feature that would change existing functionality) Checklist - I have read the contributing guidelines <https://github.com/twbs/bootstrap/blob/main/.github/CONTRIBUTING.md> - My code follows the code style of the project *(using npm run lint)* - [ x] My change introduces changes to the documentation - [x ] I have updated the documentation accordingly - [x ] I have added tests to cover my changes - All new and existing tests passed Live previews - https://deploy-preview-{your_pr_number}--twbs-bootstrap.netlify.app/ Related issues ------------------------------ You can view, comment on, or merge this pull request online at: #38470 Commit Summary - 2cc580e <2cc580e> Docs: remove remnants of Twitter / bump dates (#37779) - 212c0df <212c0df> Docs: Make theme switcher accessible (#37780) - 5a0899d <5a0899d> Fix cards color for contextual color mode - d0b0fec <d0b0fec> Fix code color in callouts - dbdfab8 <dbdfab8> Update tooltips.md - 0d64dc6 <0d64dc6> Docs: offcanvas toggles accessibility fixes, fully hide layout template input - e60002b <e60002b> Docs: add CSS variables section in close button section - e30916b <e30916b> Change nav focus to focus-visible (#37784) - 19d547b <19d547b> fix live toast demo (#37590) - 3ee2a75 <3ee2a75> Use Bootstrap colors in syntax highlighting - 9013c98 <9013c98> Docs: add explanation of the base `.btn` class (#37275) - da1c968 <da1c968> Remove dark mode --bs-heading-color value, set to null, and add custom styles for the docs dark mode headings - 8546804 <8546804> Add webpack build to webpack guide - f692ecd <f692ecd> Docs: fix accordion flush description - 33d520e <33d520e> Build(deps-dev): Bump eslint from 8.30.0 to 8.31.0 - d840a68 <d840a68> Build(deps-dev): Bump rollup from 3.9.0 to 3.9.1 - 974c50b <974c50b> Build(deps-dev): Bump stylelint from 14.16.0 to 14.16.1 - fa87dae <fa87dae> Change stylelint `property-blacklist` to `property-disallowed-list` - d13c8f6 <d13c8f6> Build(deps): Bump json5 from 1.0.1 to 1.0.2 - 89f9ffc <89f9ffc> Rewrite some callouts to remove most headings and reduce their content - d70b5db <d70b5db> Add new link utilities, icon link helper, and update colored link helpers (#37762) - 803d9d4 <803d9d4> Docs: fix headings color in light/dark mode (#37802) - 846d660 <846d660> Include twbs/examples in the Examples page - 8a35408 <8a35408> Docs: replace `twbs/bootstrap-npm-starter` by `twbs/examples/tree/main/icons-font` (#37671) - 9c1aa67 <9c1aa67> Remove unused comment in `scss/_maps.scss` - 1c05a88 <1c05a88> Remove duplicate definition of `--bs-highlight-bg` in `scss/_root.scss` - 1b83ab2 <1b83ab2> Docs: remove some CSS from `.highlight-toolbar` def - d17d2ab <d17d2ab> Docs: enhance colors description table - 702a3b6 <702a3b6> Fix duplicate `--bs-emphasis-color` set value (#37809) - fd1ec97 <fd1ec97> Docs: Small enhancements (#37803) - ffbe6e9 <ffbe6e9> Drop unused `.bg-body-emphasis` (#37824) - 7399b13 <7399b13> Docs: fix `.btn-clipboard` and `.btn-edit` link hover color - 8265927 <8265927> CSS: rename some variables to be consistent (#37804) - 1ed86c9 <1ed86c9> Fix - eb10b70 <eb10b70> Switch from none keyword value to a fake shadow for btn-link - 980116e <980116e> Docs: missing deprecated callout for `list-group-item-variant()` mixin - 1e33cfa <1e33cfa> Keep shadows black regardless of color mode - 3990571 <3990571> Remove autofocus on theme switch when page is loaded - 1871531 <1871531> Docs: add `.fw-medium` utility class example - 927ccdf <927ccdf> Remove obsolete comment from `_variables.scss` - 3fc305b <3fc305b> Docs: fix typo in migration guide - f40e76d <f40e76d> Update snippet examples for dark mode (#37834) - a901027 <a901027> Update colored links, add new `.link-body-emphasis` helper (#37833) - 81582ad <81582ad> Build(deps-dev): Bump postcss from 8.4.20 to 8.4.21 (#37851) - 79e006b <79e006b> Build(deps-dev): Bump @babel/core from 7.20.7 to 7.20.12 (#37850) - 791c44c <791c44c> docs: updates `.text-*-left` changes - 748702d <748702d> Reduce bootstrap-grid.css content - 47580ff <47580ff> Drop duplicate `--bs-body-bg-rgb` declaration + reorder props - 2d57b88 <2d57b88> Docs: fix broken links in Color modes page - f23e203 <f23e203> Mention deprecated classes for color mode on offcanvas - 60714e3 <60714e3> Add theme maps specific to dark mode (#37843) - 4536f60 <4536f60> Docs: update progress markup in Color modes page - 17f14ac <17f14ac> Remove outdated comment from `$input-border-color` variable - 8865b46 <8865b46> Move form-text paragraph to Form control page instead of overview to have teh documentation in the same page than sass variables. - 934d7a0 <934d7a0> Changed ```popover``` to ```tooltip``` in docs - 9042efd <9042efd> Deprecate the Sass var and remove any occurence of the `.text-muted` (#37890) - 5072307 <5072307> Update grid example - b3febfb <b3febfb> Better use of CSS var - ca88999 <ca88999> Fix `.form-control` in dark mode (#37893) - 779baab <779baab> Small color mode docs CSS fixes (#37896) - a799f01 <a799f01> Include variables-dark in the import stacks, plus a customize overview fix - 436de31 <436de31> Add docs callout for utilities that don't respond to color modes - eec5015 <eec5015> Typo - 20ab821 <20ab821> Sass docs updates (#37897) - e8b7d38 <e8b7d38> Correction - 5dc7f4c <5dc7f4c> Harmonize the doc - 16aff74 <16aff74> Proposal - 1369b81 <1369b81> Fix Android Chrome input date dimensions (#36143) - bada2b9 <bada2b9> Proposal - d9d2b4f <d9d2b4f> fix typo in gutters doc (#37918) - cfd3560 <cfd3560> Docs: add overflow and text color info to progress bar page (#37921) - 15744ee <15744ee> Proposal to rename the CSS and Sass variables - 1299b16 <1299b16> Docs: tweak icon link and callouts (#37923) - 03983e5 <03983e5> Rewrite selector to help Parcel compiler - cf6972c <cf6972c> Remove list-style reset on .carousel-indicators - 82391bc <82391bc> Theme color improvements (#37953) - 3635f2c <3635f2c> Build(deps-dev): Bump eslint-plugin-import from 2.26.0 to 2.27.5 - e69b618 <e69b618> Build(deps-dev): Bump rollup from 3.9.1 to 3.10.1 - 06f8927 <06f8927> Build(deps-dev): Bump eslint from 8.31.0 to 8.32.0 - a6b39f5 <a6b39f5> Build(deps-dev): Bump clean-css-cli from 5.6.1 to 5.6.2 - d005393 <d005393> Build(deps): Bump ua-parser-js from 0.7.32 to 0.7.33 (#37957) - 1a4b18c <1a4b18c> Build(deps-dev): Bump hugo-bin from 0.97.0 to 0.98.0 (#37946) - d9037ba <d9037ba> Build(deps-dev): Bump @rollup/plugin-commonjs from 24.0.0 to 24.0.1 (#37945) - c735b2e <c735b2e> Migration guide changes for v5.3.0-alpha2 (#37862) - 6393062 <6393062> Use color mode adaptive color for disabled dropdown menu items - 3ce4fed <3ce4fed> Avoid inheritance issues on border-width utilities - 99e3724 <99e3724> Add mention to migration guide - aff8f0d <aff8f0d> Remove redundant space in forms/validation.md - af60065 <af60065> Fix alerts colors by using `*-text-emphasis` CSS vars in Sass loop (#38003) - cbc4e3a <cbc4e3a> Fix list group colors by using `*-text-emphasis` CSS vars in Sass loop (#38008) - 2975911 <2975911> Build(deps-dev): Bump eslint from 8.32.0 to 8.33.0 (#37984) - 52656db <52656db> Build(deps-dev): Bump sass from 1.57.1 to 1.58.0 (#38017) - 9f5dca0 <9f5dca0> Remove `debug` references from DocSearch v2 (#38032) - 7432ebc <7432ebc> Unify `offcanvas` `keydown` event logic with `modal` (#38025) - f5f6c5c <f5f6c5c> Minor fix to avoid creating void elements in tooltip test file (#38034) - 80a5266 <80a5266> Fix `$grid-breakpoints` SCSS unit tests init (#38037) - a0e8568 <a0e8568> Remove comments from `scss/_nav.scss` (#38038) - 70bad9b <70bad9b> Docs: uniformize disabled nav links for underline nav - 7bffd6e <7bffd6e> Docs: Progress fix + proposal (#38014) - 02bb371 <02bb371> Build(deps-dev): Bump sass from 1.58.0 to 1.58.1 - 8379724 <8379724> Build(deps-dev): Bump eslint from 8.33.0 to 8.34.0 - 2f75915 <2f75915> Build(deps-dev): Bump lockfile-lint from 4.10.0 to 4.10.1 - 3e3938f <3e3938f> Build(deps-dev): Bump rollup from 3.10.1 to 3.15.0 - 68afebe <68afebe> Docs: Use ESM Popper CDN reference in 'Using Boottrap as a module' - 30e8d13 <30e8d13> Remove unused partials and add some way to automatically detect it (#38004) - d0fece9 <d0fece9> Docs: add scroll-margin-top for keyboard navigation - 9dd42e1 <9dd42e1> Attempt to fix focus ring being cut off in table of contents (#37965) - 8fddb9f <8fddb9f> Update form validation styles to use new CSS variables for `color` and `border-color` (#38044) - f256874 <f256874> More updates to migration guide - 2dc329d <2dc329d> WIP: New snippet examples (#36309) - d86c316 <d86c316> Drop duplicate `$btn-close-focus-shadow` definition - f8fa05d <f8fa05d> Remove -moz-padding-start from .form-select - 2b31a6b <2b31a6b> Fix color picker borders on chromium based browsers - 42e99cc <42e99cc> Reduce size of guide dev server images (#37741) - 3122127 <3122127> Fix console error in examples pages du to no theme switcher (#38074) - 5241b98 <5241b98> Bump Chart.js from 2.9.4 to 4.2.1 in dashboard examples (#38071) - d576590 <d576590> Fix shadow of .btn-link - 28d9c0c <28d9c0c> Build(deps-dev): Bump sass from 1.58.1 to 1.58.3 (#38100) - a6d774c <a6d774c> Build(deps-dev): Bump rollup from 3.15.0 to 3.17.2 (#38097) - f44feab <f44feab> Tests: remove unnecessary `id`/`aria-labelledby` from collapse unit tests (#38089) - 0d27f3c <0d27f3c> Remove useless comment from `scss/_utilities.scss` (#38104) - 78f879e <78f879e> Docs: drop unused icons (#38103) - afd3736 <afd3736> Drop duplicate `$nav-link-disabled-color` declaration (#38083) - 2e2ca49 <2e2ca49> Merge branch 'main' into btn-link - c634528 <c634528> Merge pull request #38086 from Sir-Genius/btn-link - 51299bf <51299bf> Drop unused `--bs-focus-ring-box-shadow` and add documentation for `--bs-focus-ring-{x|y|blur}` (#38095) - 6b4b77e <6b4b77e> Docs: Drop unused `.focused` style (#38087) - 80ba848 <80ba848> Docs: fix code indentation in homepage JavaScript plugins section (#38112) - 23d20fa <23d20fa> Utilities: add 0 value to `link-underline-opacity` (#38131) - 8a72501 <8a72501> Build(deps): Bump coverallsapp/github-action from 1.1.3 to 1.2.2 - 34901f1 <34901f1> Docs: rollback some modification about `.text-muted` deprecation messages - 38a4310 <38a4310> Docs: replace 'popover' by 'tooltip' in tooltip's page' options section - b8b8166 <b8b8166> Docs: `.text-body-secondary` appears two times in Utilities > Colors - 912cfe5 <912cfe5> Fix dropdown toggle visible focus in headers example - 7832136 <7832136> Icon link: envariable + enhance the documentation (#38130) - dbc021b <dbc021b> Fix navbar-nav link styling - 9a1f4ed <9a1f4ed> Fix button visibility issue on dark theme (#38115) - b26233c <b26233c> Examples: color mode enhancement (#38144) - ea19c3d <ea19c3d> Fixed some grammar issues - d5f4532 <d5f4532> Docs: fix overflow:auto horizontal scrollbars covering last line of code blocks (#37694) - cff5c60 <cff5c60> Docs: vertically align starters images in example page (#38179) - 833da72 <833da72> Fix missing modifications when `--bs-{color}-text` was changed to `--bs-{color}-text-emphasis` (#38176) - 423f112 <423f112> Docs: minor modifications in our migration guide for the v5.3.0-alpha2 (#38177) - 039f3d1 <039f3d1> Remove comments from `scss/_utilities.scss` (#38181) - 3cec38c <3cec38c> Fixes click area for header example snippet - a3f8480 <a3f8480> Remove nesting color modes docs section (#38192) - 2a2c4ab <2a2c4ab> Docs: fix typo in Color modes page (#38198) - a7e0114 <a7e0114> Remove useless import - 1f7e7eb <1f7e7eb> Better use the CSS - 8e27427 <8e27427> Improve `scss-docs` link - 2032a6a <2032a6a> Docs: Remove unnecessary `href` and `tabindex="-1"` (#38196) - 2a9308b <2a9308b> Update workflow - 24130a4 <24130a4> Fix typo in `utilities/colors.md` (#38194) - 25579aa <25579aa> Fix (#38191) - fd7cfac <fd7cfac> Improve docs on Modals, Alerts, Offcanvas and Toasts close triggers examples (#38182) - 9c0b2be <9c0b2be> Update _carousel.scss - 6f18ad9 <6f18ad9> Update buttons.md (#38169) - 59c556c <59c556c> Drop unused `bootstrap-social-logo.png` - c57be44 <c57be44> Docs: consistent usage of CSS sections (#38175) - 7bc4f4f <7bc4f4f> Build(deps-dev): Bump nodemon from 2.0.20 to 2.0.21 (#38186) - e9355c6 <e9355c6> Build(deps-dev): Bump eslint-plugin-unicorn from 45.0.2 to 46.0.0 (#38187) - e00d06e <e00d06e> Fix wrong generation of `aria-labelledby` in tab navigation (#38223) - ebcb6c4 <ebcb6c4> Build(deps): Bump coverallsapp/github-action from 1.2.2 to 1.2.4 (#38183) - ca1dd22 <ca1dd22> Specify lockfile-version=2 for older npm compatibility (#38226) - 3b632cd <3b632cd> Update minor dependencies (#38229) - ca6dfad <ca6dfad> Move --printUnusedTemplates in hugo scripts (#38227) - 898cfc7 <898cfc7> Update codeql.yml (#38225) - 6a043d9 <6a043d9> Remove empty script tag (#38233) - 474bf2a <474bf2a> Guard more in color-modes.js (#38235) - c400653 <c400653> Tweak stylelint config (#38228) - adf7b8d <adf7b8d> Docs: use core mixins in a couple of places (#38236) - fe786cd <fe786cd> Update hugo-bin to v0.100.0 (#38243) - 4ba2deb <4ba2deb> Docs: consistent deprecation messages in Close Button dark variant (#38247) - 8701d89 <8701d89> icon-link.md: remove moot aliases (#38246) - c128b90 <c128b90> Build(deps-dev): Bump hugo-bin from 0.100.0 to 0.101.0 (#38264) - 0086258 <0086258> Build(deps-dev): Bump sass from 1.59.2 to 1.59.3 (#38265) - fa4854f <fa4854f> Build(deps-dev): Bump find-unused-sass-variables from 4.0.5 to 4.0.6 (#38269) - 52ef707 <52ef707> Build(deps-dev): Bump @babel/core from 7.21.0 to 7.21.3 (#38266) - 5414880 <5414880> Build(deps-dev): Bump jasmine from 4.5.0 to 4.6.0 (#38267) - 2d0c94c <2d0c94c> Docs: make all headings use `var(--bs-emphasis-color)` (#38262) - 6855ce9 <6855ce9> Revert "Guard more in color-modes.js (#38235)" (#38280) - f52d4a3 <f52d4a3> Fix `placeholder` shortcode color and background params when 'img' markup (#38263) - 5d40483 <5d40483> Slightly improve examples PNG files (#38270) - a6d8aa8 <a6d8aa8> Proposal to use `scroll-margin-top` instead of introducing padding and negative margin (#38220) - 43ec90b <43ec90b> Update dependabot.yml - 71d5286 <71d5286> Build(deps-dev): Bump hugo-bin from 0.101.0 to 0.101.2 (#38289) - 4345a3c <4345a3c> Build(deps-dev): Bump rollup from 3.19.1 to 3.20.0 (#38290) - 7d03805 <7d03805> Build(deps): Bump coverallsapp/github-action from 1.2.4 to 2.0.0 (#38288) - c2671ec <c2671ec> CI: limit the on push triggers (#38291) - ab049cd <ab049cd> Remove version comment from JavaScript src files (#38294) - fdcb9b1 <fdcb9b1> Update browserstack.yml - 00fc712 <00fc712> Update browserstack.yml (#38303) - 842fd50 <842fd50> Remove version from index.{esm,umd}.js too (#38302) - b3faa0c <b3faa0c> docs: remove moot `v` from docs-versions.yml (#38301) - 99867eb <99867eb> Update Vite, Parcel and Webpack guides (#38305) - aadfe7e <aadfe7e> Fix comment position in `assets/scss/_content.scss` (#38281) - e873048 <e873048> vnu-jar.js: add more logging (#38314) - 0653e7f <0653e7f> Fix reference to twbs/examples/icons-font + fine-tune index.html SB location target (#38310) - 2008c65 <2008c65> Docs: fix two class attributes on same button (#38317) - f8a56da <f8a56da> Docs: `scss-docs` unindent automatically the code inside shortcode - c877cef <c877cef> Release v5.3.0-alpha2 (#38244) - aa50e23 <aa50e23> scss: bring light/dark accordion icon color handling to parity - 33ad338 <33ad338> Update display utility - 3b9b154 <3b9b154> Use `border-radius` CSS variables in more components (#38284) - 208ba3d <208ba3d> Document new .d-inline-grid utility - d533e6f <d533e6f> Fix tooltip body placement with variation placements - f771171 <f771171> Update selectors for carousel media query color mode option (#38328) - cd89088 <cd89088> Add `media-query` color mode Sass test (#38326) - 74431bd <74431bd> Update dependencies and regenerate package-lock.json (#38329) - 43bc20a <43bc20a> Update dependencies (#38330) - d76ee28 <d76ee28> Fixed typo in 5.3.0-alpha2 migration - 2bbf670 <2bbf670> Change diff file path in Webpack guide (#38339) - 1729bcc <1729bcc> docs: remove trailing newline when copying snippets (#38321) - e34cf6a <e34cf6a> Build(deps-dev): Bump hugo-bin from 0.101.4 to 0.101.5 (#38341) - 31f93e2 <31f93e2> Docs: fix Markdown table with empty column (#38342) - 06f7c3b <06f7c3b> Add js-docs shortcode to ensure consistency between doc and js code (#38316) - 94c7dc7 <94c7dc7> Add detailed explanation of the JS components configuration merging process (#37303) - cad38ef <cad38ef> README.md: fix JS Tests link (#38343) - 92f9dda <92f9dda> Add a check for interpolation variables to node-sass workflow (#38283) - 34c2725 <34c2725> Docs: `js-docs` unindent automatically the code inside shortcode (#38349) - c5fde53 <c5fde53> Docs: update Webpack guide (#38345) - 1fe9067 <1fe9067> zip scripts: remove previous zip files and add quiet flag (#38358) - c953096 <c953096> event-handler: switch to const (#38362) - 7a7fc1a <7a7fc1a> Modal: drop loop (#38368) - 3aabfc7 <3aabfc7> Another pass at fixing floating labels disabled colors (#38313) - ae43f0c <ae43f0c> Tweak and re-organize ESLint config (#38369) - 3ba7ca4 <3ba7ca4> Update RFS to v10.0.0 - <74c6f2b>