diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..62a8466 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,6 @@ +[submodule "story-editor/QHexView"] + path = story-editor/QHexView + url = https://github.com/arabine/QHexView +[submodule "story-editor/nodeeditor"] + path = story-editor/nodeeditor + url = https://github.com/arabine/nodeeditor.git diff --git a/docs/archetypes/default.md b/docs/archetypes/default.md new file mode 100644 index 0000000..00e77bd --- /dev/null +++ b/docs/archetypes/default.md @@ -0,0 +1,6 @@ +--- +title: "{{ replace .Name "-" " " | title }}" +date: {{ .Date }} +draft: true +--- + diff --git a/docs/config.toml b/docs/config.toml new file mode 100644 index 0000000..459a437 --- /dev/null +++ b/docs/config.toml @@ -0,0 +1,45 @@ +baseURL = "https://example.com" + +languageCode = "en-us" +DefaultContentLanguage = "en" +title = "Ace documentation" +theme = "ace-documentation" +pygmentsCodeFences = true +pygmentsStyle = "monokailight" + +defaultContentLanguage = "en" +defaultContentLanguageInSubdir= false +enableMissingTranslationPlaceholders = false + +# Enable Google Analytics by entering your tracking id +googleAnalytics = "" + +[params] +ordersectionsby = "weight" # ordersectionsby = "title" +disableSearch = false # default is false +disableReadmoreNav = true # set true to hide prev/next navigation, default is false +highlightClientSide = false # set true to use highlight.pack.js instead of the default hugo chroma highlighter +menushortcutsnewtab = true # set true to open shortcuts links to a new tab/window + +[markup] + [markup.goldmark] + [markup.goldmark.renderer] + unsafe = true + +[outputs] +home = [ "HTML", "RSS", "JSON"] + +[[menu.shortcuts]] +name = "More from us" +url = "https://vantage-design.com" +weight = 1 + +[[menu.shortcuts]] +name = "" +url = "https://github.com/vantagedesign/ace-documentation" +weight = 2 + +[[menu.shortcuts]] +name = "" +url = "https://github.com/vantagedesign/ace-documentation/releases" +weight = 3 diff --git a/docs/content/_index.md b/docs/content/_index.md new file mode 100644 index 0000000..c358176 --- /dev/null +++ b/docs/content/_index.md @@ -0,0 +1,149 @@ ++++ +title = "Ace documentation" +description = "Ace is a theme for Hugo, a fast static website generator written in Go, that allows you to easily write well organized and clean documentation for your projects." ++++ + +{{< lead >}} +Ace is a theme for Hugo, a fast static website generator written in Go, that allows you to easily write well organized and clean documentation for your projects. It's as easy as writing your content in Markdown, running Hugo to generate static HTML, CSS and Javascript files and deploying those to your web server. +{{< /lead >}} + + +## Features +
+
+
+
+ +
+
+
+ Fast. +
+

+ Static files generated in less than a second. And served to your visitors just as fast. +

+
+
+
+
+
+
+ +
+
+
+ Minimalistic. +
+

+ A clean look to keep your user's attention to the content that matters: your documentation. +

+
+
+
+
+
+
+ +
+
+
+ For every project. +
+

+ Hugo does not require Java, Python or Ruby and is available as a simple binary or through NPM and other package managers. +

+
+
+
+
+
+
+ +
+
+
+ Automatic. +
+

+ Folders and files are automatically added in the menu depending on your file and folder structure. +

+
+
+
+
+
+
+ +
+
+
+ Full search. +
+

+ Easily find the content you look for through the search function. +

+
+
+
+
+
+
+ +
+
+
+ Code highlighting. +
+

+ Code highlighting. Include code samples with a copy button. If it’s HTML, you can also render the code. +

+
+
+
+
+
+
+ +
+
+
+ Useful shortcodes. +
+

+ Code, buttons, alerts, leads, collapse, panels, images, videos and more. +

+
+
+
+
+
+
+ +
+
+
+ Built with Bootstrap. +
+

+ Built with Bootstrap 4. Fully responsive out of the box. Build and style page elements using Bootstrap. +

+
+
+
+
+
+
+ +
+
+
+ Icons. +
+

+ Packed with Font Awesome. Empower your content with a shit ton of awesome icons. +

+
+
+
+
+ diff --git a/docs/content/configuration/_index.md b/docs/content/configuration/_index.md new file mode 100644 index 0000000..8eb4f3e --- /dev/null +++ b/docs/content/configuration/_index.md @@ -0,0 +1,68 @@ ++++ +title = "Configuration" +description = "" +weight = 2 ++++ + +{{< lead >}} +Customize and tweak Ace using a number of configuration options. +{{< /lead >}} + + +## Page ordering + +By default, pages are sorted on the weight assigned to them in their frontmatter. This is set in config.toml, using orderSectionsby = "weight". Change this to "title" to sort pages alphabetically based on their title instead. Alternatively, do not assign a weight to any pages and it will also sort them alphabetically on their title. + + +## Table of contents + +By default, a table of contents (ToC) is generated for each page in the right side menu. This can be disabled using: + +{{< code >}} +toc = false +{{< /code >}} + +in the config.toml or the frontmatter (a page's markdown file) for a page-wide or page-specific disabling of the ToC respectively. + + +## Logo + +An optional site logo can be specified: + +{{< code >}} +site_logo = /logo.svg +{{< /code >}} + + +## Google Analytics + +Enable Google Analytics by adding your GA tracking ID to the config.toml file, at: +{{< code >}} +googleAnalytics = "XX-XXXXXXXXX-X" +{{< /code >}} +Where XX-XXXXXXXXX-X is your tracking ID. + + +## Read more navigation + +In config.toml or a page's frontmatter, set disableReadmoreNav = true to disable the prev/next buttons at the bottom of every page. + + +## Search + +Disable search by setting disableSearch = true in config.toml. + +The local search feature is based on the content of `index.json`, which is generated based on a configurable template. +Search results are presented as a drop-down list attached to the search input field while typing. + + +## Custom CSS + +You can override the built-in css by using your own. Just put your own css files in the `static` directory of your website (the one in the theme directory also works but is not recommended) and modify the `custom_css` parameter in your config file. The path referenced in the parameter should be relative to the `static` folder. These css files will be added through the `header` partial after the built-in css file. + +For example, if your css files are `static/css/custom.css` and `static/css/custom2.css` then add the following to the config file: + +``` + [params] + custom_css = ["css/custom.css","css/custom2.css"] +``` diff --git a/docs/content/getting-started/_index.md b/docs/content/getting-started/_index.md new file mode 100644 index 0000000..b91ff7b --- /dev/null +++ b/docs/content/getting-started/_index.md @@ -0,0 +1,14 @@ ++++ +title = "Getting started" +description = "" +weight = 1 ++++ + +{{< lead >}} +Get started with Ace docs, the easy way to generate a static website for your project's documentation. +{{< /lead >}} + +Installation and configuration is easy and can be easily applied to any project. No need to be dependent on Python, Ruby or Java. Hugo runs from a simple binary and works through the command line. +Explore the following pages to learn how to build awesome documentation for your project using Ace. + +{{< childpages >}} diff --git a/docs/content/getting-started/installation.md b/docs/content/getting-started/installation.md new file mode 100644 index 0000000..cb547b0 --- /dev/null +++ b/docs/content/getting-started/installation.md @@ -0,0 +1,50 @@ ++++ +title = "Installation" +description = "" +weight = 1 ++++ + +{{< lead >}} +Installing Ace is easy. Just install the Hugo binary, create a new site and install the Ace theme. +{{< /lead >}} + +## Installing Hugo +In order to run this theme, you need to install Hugo on your system. +This theme requires Hugo's extended version to support SCSS compilation, so make please sure you install the extended version. +For more detailed information and other methods of installation you can visit the Hugo installation guide. + +There may be other ways to install Hugo that are more applicable for your project. For example, you can use the NPM package hugo-bin to include Hugo in a project that already uses NPM packages. + +### Checking your Hugo installation +Run the following command in your terminal to check if Hugo is installed. +{{< code lang="bash" >}} +hugo version +{{< /code >}} +Make sure the version name mentions extended, to indicate you've installed the extended version of Hugo, which is required for this theme. + +## Creating a site +Create a new site *docs* (you may choose any name you want). In your projects root folder, run the following command: +{{< code lang="bash" >}} +hugo new site docs +{{< /code >}} +This will create a new folder /docs with all required files in it. + +### Installing the theme +Download and copy the theme files into /docs/themes/ace-documentation or use git to clone the repository to that directory: +{{< code lang="bash" >}} +cd docs +cd themes +git clone https://github.com/vantagedesign/ace-documentation +{{< /code >}} + +After theme installation, the /docs/themes/ace-documentation folder should contain the file theme.toml, along with all other theme files. + +### Configuring your hugo site to use the theme +Inside your site's folder, /docs, you will find a file called config.toml. This is the configuration file for your site. Open it and configure it to use the Ace theme by setting the following value: +{{< code lang="toml" >}} +theme = "ace-documentation" +{{< /code >}} + + +## Installing example content +You can add some sample content to your site by placing the contents of the exampleSite directory in your /docs directory. diff --git a/docs/content/getting-started/usage.md b/docs/content/getting-started/usage.md new file mode 100644 index 0000000..a4cdbbd --- /dev/null +++ b/docs/content/getting-started/usage.md @@ -0,0 +1,86 @@ ++++ +title = "Usage" +description = "" +weight = 2 ++++ + +{{< lead >}} +With the site created and the theme installed, it's time to run the server and create content. +{{< /lead >}} + +## Starting & building the site +### Development server +To start the site for development mode, execute the following command while in your /docs folder: +{{< code lang="bash" >}} +hugo server +{{< /code >}} +This will start a server on your localhost that will live-update with any changes you make to your site. + +For more Hugo commands visit https://gohugo.io/commands/ + +### Building for production +To build the site for your production environment, as in, to serve it to your users through a web server, execute the following command. This will create a folder /docs/public with all the necessary files, compiled to HTML. + +
Be sure the site's configuration in config.toml is complete, including the baseURL = "https://yourdomain.com/" value to properly load stylesheets and other resources. +{{< code lang="bash" >}} +hugo +{{< /code >}} + + +## Creating content +### Markdown +Pages are written in Markdown and files defining pages should end with *.md*. For more information on how to use Markdown, search for tutorials on the internet or use this cheatsheet. + +### File structure +Ace looks at your file structure and automatically turns it into a menu. +The structure looks as follows: +{{< code >}} +/content +├── _index.md +├── page-top.md +└── /level-one + ├── _index.md + ├── page-1-one.md + ├── page-1-two.md + └── /level-two + ├── _index.md + ├── page-2-one.md + ├── page-2-two.md + └── /level-three + ├── _index.md + ├── page-3-one.md + ├── page-3-two.md + └── /level-four + ├── page-4-one.md + └── page-4-two.md +{{< /code >}} + +Your 'homepage' for every level is the _index.md file. Subpages (like page-1-one.md) are automatically added as child pages in the menu. + +An exception exists for the top level files. /content/_index.md is your homepage, and any other page files in the /content folder are not automatically added in the menu. Instead, they can be accessed manually through their URL (yourdomain.com/page-title). + +### File contents +Every file should start by defining the title and weight of the page. This can be done by adding the following text to the top of your page file. +{{< code lang="markdown" >}} ++++ +title = "Usage" +description = "" +weight = 2 ++++ +{{< /code >}} +The title will be displayed as a H1 header at the top of your page. The weight determines the order in the menu. + +After that you may write the content you desire with Markdown. You may use shortcodes to add some more 'advanced' layout features to the page, such as code highlighting, a 'lead' style paragraph, images, video's, and more. + +### Navigation bar menu +While the left sidebar navigation is automatically populated by the file structure described above, and the right 'table of contents' sidebar menu is automatically populated by the headings defined on a page, the top navigation bar needs to be configured manually. +
+This can be done in the config.toml file, by adding the following lines: +{{< code lang="toml" >}} +[[menu.shortcuts]] +name = "" +url = "https://github.com/vantagedesign/ace-documentation" +weight = 10 +{{< /code >}} + +This example will create a GitHub icon that links to that URL. Instead of an icon, you may also use text, or both. diff --git a/docs/themes/ace-documentation/CHANGELOG.md b/docs/themes/ace-documentation/CHANGELOG.md new file mode 100644 index 0000000..17eb2be --- /dev/null +++ b/docs/themes/ace-documentation/CHANGELOG.md @@ -0,0 +1,26 @@ +## Version 1.0.4 + - Updated Bootstrap to v4.5 + +## Version 1.0.3 + - [FIX] Typo in readme, added changelog, updated config.toml in exampleSite + - [FIX] Remove source map imports from JS files ([@jhollowe, PR #8](https://github.com/vantagedesign/ace-documentation/pull/8)) + - [FIX] Fix minifier error with spacing in next-prev-page ([@jhollowe, PR #6](https://github.com/vantagedesign/ace-documentation/pull/6)) + - [ADD] Allow disabling the TOC ([@jhollowe, PR #9](https://github.com/vantagedesign/ace-documentation/pull/9)) + - [ADD] Allow Google Analytics to only track production site ([@jhollowe, PR #7](https://github.com/vantagedesign/ace-documentation/pull/7)) + - [FIX] Prevent empty heaver toggler ([@jhollowe, PR #3](https://github.com/vantagedesign/ace-documentation/pull/3)) + - [ADD] New table shortcode for styled tables (fixes [issue #2](https://github.com/vantagedesign/ace-documentation/issues/2)) + - [ADD] Allow disabling the Read more navigation per page or for the entire site using the config (implements [issue #10](https://github.com/vantagedesign/ace-documentation/issues/10)) + - [ADD] Documentation for various config options, such as disabling toc, readmore, analytics and search. + + +## Version 1.0.2 + +- [FIX] Fixed folder structure in exampleSite for non-extended Hugo version. + +## Version 1.0.1 + +- [FIX] Include the resources folder in the theme for Hugo standard version. + +## Version 1.0.0 + + - Initial release \ No newline at end of file diff --git a/docs/themes/ace-documentation/LICENSE.md b/docs/themes/ace-documentation/LICENSE.md new file mode 100644 index 0000000..a8a28e8 --- /dev/null +++ b/docs/themes/ace-documentation/LICENSE.md @@ -0,0 +1,20 @@ +The MIT License (MIT) + +Copyright (c) 2020 Vantage Design + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/docs/themes/ace-documentation/README.md b/docs/themes/ace-documentation/README.md new file mode 100644 index 0000000..ac91aab --- /dev/null +++ b/docs/themes/ace-documentation/README.md @@ -0,0 +1,84 @@ +# [Ace documentation](https://docs.vantage-design.com/ace) + +![Product thumbnail](https://raw.githubusercontent.com/vantagedesign/assets/master/ace-documentation/ace-thumbnail-shadow.png) + +Create beautiful documentation for your projects with Ace for Hugo. Powered by Bootstrap and SASS, featuring must-have features such as syntax highlighting, copy-able code blocks, full search, a responsive layout and the power of Markdown to create your content. + +Writing documentation has never been so easy. + +### Rich in features +Ace offers a variety of custom components and features which are a must-have for building project documentation. Code blocks are enriched with syntax highlighting and a copy button, allowing for your users to easily read your code and copy it into their project. Furthermore, a special version of the code block renders the HTML content in both the code block and on the page, giving your users a preview of what the code looks like. + +Other shortcodes allow you to use Bootstrap components in your content, such as alerts, buttons, panels, collapse elements and more. + +Full search allows your users to quickly find the content they require, and a responsive design makes your documentation available on both desktop and mobile devices. + +### Beautiful minimalist design +With a minimal design, the attention of users is focused on that which matters: your content. + + + +## Demo & documentation +The documentation for Ace was, of course, built with Ace. Therefore, the documentation for Ace also serves as a demo. + + - [Ace demo & documentation](https://docs.vantage-design.com/ace) + + + +## Installation + +- [Download from GitHub](https://github.com/vantagedesign/ace-documentation/releases) +- Clone the repo `git clone https://github.com/vantagedesign/ace-documentation.git` + +*Note:* this theme only works with Hugo's extended version, due to the SCSS compile functionality. + + + +## Resources + +- [Store page](https://vantage-design.com/products/documentation-themes/4/ace-documentation) +- [Demo](https://docs.vantage-design.com/ace) +- [Documentation](https://docs.vantage-design.com/ace) +- [Issues](https://github.com/vantagedesign/ace-documentation/issues) +- [License](https://github.com/vantagedesign/ace-documentation/blob/master/LICENSE.md) + + + +## Reporting Issues + +We use GitHub Issues as the official bug tracker for the Ace documentation. When reporting an issue, please follow the following guidelines: + +1. Make sure that you are using the latest version of Ace documentation. +2. Provide us with reproducible steps for recreating the issue, in order for us to find the issue and fix is as soon as possible. +3. Specify your browser and version of Ace. + + + +## Contributing to Ace + +Contributions are highly appreciated and may be done by reporting issues with new feature suggestions or bug fixes, or by making pull requests. We'll try our best to get those sorted as soon as possible. + +Please make pull requests to the [dev branch](https://github.com/vantagedesign/ace-documentation/tree/dev). Make sure you're always running the latest version of Ace and that you are not committing breaking changes. + + + +## Licensing + +- Copyright 2020 [Vantage Design](https://vantage-design.com) +- Licensed under MIT (https://github.com/vantagedesign/ace-documentation/blob/master/LICENSE.md) + + + +## Useful links + +- [More products](https://vantage-design.com) +- [Free products](https://vantage-design.com/products/free-products/) +- [Premium products](https://vantage-design.com/products/premium-products/) +- [Design systems](https://vantage-design.com/products/design-systems/) +- [Page templates](https://vantage-design.com/products/page-templates/) +- [Documentation themes](https://vantage-design.com/products/documentation-themes/) + +### Social Media + +- Facebook: +- Instagram: diff --git a/docs/themes/ace-documentation/archetypes/default.md b/docs/themes/ace-documentation/archetypes/default.md new file mode 100644 index 0000000..ac36e06 --- /dev/null +++ b/docs/themes/ace-documentation/archetypes/default.md @@ -0,0 +1,2 @@ ++++ ++++ diff --git a/docs/themes/ace-documentation/assets/css/ace.scss b/docs/themes/ace-documentation/assets/css/ace.scss new file mode 100644 index 0000000..1e47ad2 --- /dev/null +++ b/docs/themes/ace-documentation/assets/css/ace.scss @@ -0,0 +1,131 @@ +/* ------------------------------------------------------------------------- +* ACE DOCUMENTATION +* Stylesheet +* @author Vantage Design +* @version 1.0.4 +* @license https://github.com/vantagedesign/ace-documentation/blob/master/LICENSE +* ------------------------------------------------------------------------ */ + +$primary: #007bff; +$secondary: #6610f2; +$success: #28a745; +$info: #17a2b8; +$warning: #ffc107; +$danger: #dc3545; +$light: #f8f9fa; +$dark: #343a40; + +$docs_toc_padding_top: 10px; +$docs_toc_position_top: 4rem; + +@import "bootstrap/bootstrap"; + +/* Typography styling */ +.main > h1{ + padding-top: 2rem; +} + +.main > h2{ + padding-top: 4rem; + margin-top:-1rem; +} + +.main > h3, .main > h4, .main > h5, .main > h6{ + padding-top: 4rem; + margin-top:-3rem; +} + +.haschildren ul{ + color: gray; + display:none; +} + +.haschildren.active ul, .haschildren.parent ul{ + display:block; +} + +.highlight > pre { + padding:15px; +} + +.navbar-brand img { + height: 3rem; +} + +.feed-icons img { + height: 1.5rem; +} + +/* Side navigation menus */ +.docs-sidenav span.badge.badge-primary, .docs-toc span.badge.badge-primary{ + font-size: 10px; +} + +@media (min-width: 768px) { + .docs-sidenav, .docs-toc{ + height: calc(100vh - $docs_toc_position_top - $docs_toc_padding_top); + top: $docs_toc_position_top; + position: sticky; + overflow: auto; + } + .docs-sidenav .navbar, .docs-toc .navbar{ + padding-right: 0; + } + .docs-sidenav .navbar-collapse, .docs-sidenav .navbar-nav{ + width: 100%; + } + .docs-sidenav .nav-link, .docs-toc li a{ + display: flex; + align-items: start; + justify-content: space-between; + } + .docs-sidenav .nav-link > span.badge.badge-primary, .docs-toc li a > span.badge.badge-primary{ + margin-top: 5px; + } +} + +@media (min-width: 1200px) { + .docs-toc.large{ + height: calc(100vh - $docs_toc_position_top - $docs_toc_padding_top); + } +} + +@media (max-width: 1200px) { + .docs-toc.large{ + display:none; + } +} + +.docs-toc{ + padding-top: $docs_toc_padding_top; +} + +.docs-toc a{ + font-size: 14px; + color: gray; +} + +.docs-toc a:hover{ + color: #333; +} + +.docs-toc ul{ + list-style: none; + padding-left:8px; + margin-top:3px; +} + +.docs-toc ul:first-child{ + padding-left:0; +} + +/* Table tweak for JavaScript methods */ +table td:first-child > code{ + word-break: normal; +} + +table > tbody > tr > td, .bd-content > table > tbody > tr > th, .bd-content > table > tfoot > tr > td, .bd-content > table > tfoot > tr > th, .bd-content > table > thead > tr > td, .bd-content > table > thead > tr > th { + padding: .75rem; + vertical-align: top; + border: 1px solid #dee2e6; +} diff --git a/docs/themes/ace-documentation/assets/css/bootstrap/_alert.scss b/docs/themes/ace-documentation/assets/css/bootstrap/_alert.scss new file mode 100644 index 0000000..da2a98a --- /dev/null +++ b/docs/themes/ace-documentation/assets/css/bootstrap/_alert.scss @@ -0,0 +1,51 @@ +// +// Base styles +// + +.alert { + position: relative; + padding: $alert-padding-y $alert-padding-x; + margin-bottom: $alert-margin-bottom; + border: $alert-border-width solid transparent; + @include border-radius($alert-border-radius); +} + +// Headings for larger alerts +.alert-heading { + // Specified to prevent conflicts of changing $headings-color + color: inherit; +} + +// Provide class for links that match alerts +.alert-link { + font-weight: $alert-link-font-weight; +} + + +// Dismissible alerts +// +// Expand the right padding and account for the close button's positioning. + +.alert-dismissible { + padding-right: $close-font-size + $alert-padding-x * 2; + + // Adjust close link position + .close { + position: absolute; + top: 0; + right: 0; + padding: $alert-padding-y $alert-padding-x; + color: inherit; + } +} + + +// Alternate styles +// +// Generate contextual modifier classes for colorizing the alert. + +@each $color, $value in $theme-colors { + .alert-#{$color} { + @include alert-variant(theme-color-level($color, $alert-bg-level), theme-color-level($color, $alert-border-level), theme-color-level($color, $alert-color-level)); + } +} diff --git a/docs/themes/ace-documentation/assets/css/bootstrap/_badge.scss b/docs/themes/ace-documentation/assets/css/bootstrap/_badge.scss new file mode 100644 index 0000000..42c5d08 --- /dev/null +++ b/docs/themes/ace-documentation/assets/css/bootstrap/_badge.scss @@ -0,0 +1,54 @@ +// Base class +// +// Requires one of the contextual, color modifier classes for `color` and +// `background-color`. + +.badge { + display: inline-block; + padding: $badge-padding-y $badge-padding-x; + @include font-size($badge-font-size); + font-weight: $badge-font-weight; + line-height: 1; + text-align: center; + white-space: nowrap; + vertical-align: baseline; + @include border-radius($badge-border-radius); + @include transition($badge-transition); + + @at-root a#{&} { + @include hover-focus() { + text-decoration: none; + } + } + + // Empty badges collapse automatically + &:empty { + display: none; + } +} + +// Quick fix for badges in buttons +.btn .badge { + position: relative; + top: -1px; +} + +// Pill badges +// +// Make them extra rounded with a modifier to replace v3's badges. + +.badge-pill { + padding-right: $badge-pill-padding-x; + padding-left: $badge-pill-padding-x; + @include border-radius($badge-pill-border-radius); +} + +// Colors +// +// Contextual variations (linked badges get darker on :hover). + +@each $color, $value in $theme-colors { + .badge-#{$color} { + @include badge-variant($value); + } +} diff --git a/docs/themes/ace-documentation/assets/css/bootstrap/_breadcrumb.scss b/docs/themes/ace-documentation/assets/css/bootstrap/_breadcrumb.scss new file mode 100644 index 0000000..a0cf7e2 --- /dev/null +++ b/docs/themes/ace-documentation/assets/css/bootstrap/_breadcrumb.scss @@ -0,0 +1,44 @@ +.breadcrumb { + display: flex; + flex-wrap: wrap; + padding: $breadcrumb-padding-y $breadcrumb-padding-x; + margin-bottom: $breadcrumb-margin-bottom; + @include font-size($breadcrumb-font-size); + list-style: none; + background-color: $breadcrumb-bg; + @include border-radius($breadcrumb-border-radius); +} + +.breadcrumb-item { + display: flex; + + // The separator between breadcrumbs (by default, a forward-slash: "/") + + .breadcrumb-item { + padding-left: $breadcrumb-item-padding; + + &::before { + display: inline-block; // Suppress underlining of the separator in modern browsers + padding-right: $breadcrumb-item-padding; + color: $breadcrumb-divider-color; + content: escape-svg($breadcrumb-divider); + } + } + + // IE9-11 hack to properly handle hyperlink underlines for breadcrumbs built + // without `