Last Updated at: 8/6/2024, 4:20:14 PM
Based on the overviews of all the SCSS files in this folder, here's a high-level overview of the folder's purpose and functionality:
This folder contains a collection of SCSS (Sass) files that form the core styling system for a Docusaurus-based documentation website. The purpose of this folder is to provide a comprehensive, customizable, and modular approach to styling various components and layouts of the documentation site.
Key aspects of this styling system include:
-
Theming: It implements both light and dark themes, allowing for seamless switching between color modes.
-
Component-specific styling: Individual files target specific components like the navbar, sidebar, footer, and search bar, allowing for easy customization of each element.
-
Typography: It defines consistent typography rules for headings, paragraphs, and other text elements across the site.
-
Responsive design: The styles are built with responsiveness in mind, ensuring the site looks good on various screen sizes and devices.
-
Custom components: It includes styles for custom components like cards, buttons, and tables, enhancing the visual appeal and functionality of the documentation.
-
Code highlighting: Special attention is given to styling code blocks and syntax highlighting for better readability.
-
Utility classes: It incorporates Tailwind CSS utility classes, providing a flexible system for rapid UI development.
-
Animations and effects: The system includes custom animations, transitions, and effects like glassmorphism to enhance user experience.
-
Customizability: Each file is structured to allow easy customization, with clear sections for colors, layouts, and component-specific styles.
-
Integration with Docusaurus: The styles are tailored to work seamlessly with Docusaurus-specific elements and classes.
Overall, this folder serves as a central hub for all styling needs of the Docusaurus template, providing a flexible and powerful system that can be easily adapted to various branding and design requirements while maintaining consistency and user-friendliness across the documentation site.
This SCSS file contains custom styles for the Table of Contents component in a Docusaurus theme. It modifies the appearance and behavior of both the mobile and desktop versions of the table of contents, enhancing the user experience and visual appeal.
Key features include:
- Removal of default background styles for collapsible buttons
- Custom styling for the "On This Page" header in the desktop version
- Consistent font styling for table of contents links
- Custom hover and active states for links
- (Commented out) Styles for adding visual indicators to active links and applying backdrop filters
To customize this file for your specific needs, you can modify various aspects of the styles:
-
Collapsible Button Styles: If you want to change the appearance of the collapsible buttons, modify the
.tocCollapsibleButton_node_modules-\@docusaurus-theme-classic-lib-theme-TOCCollapsible-CollapseButton-styles-module::afterand.theme-doc-toc-mobile .tocCollapsibleButton_TO0P:afterselectors. -
"On This Page" Header: To change the text, font, or styling of the "On This Page" header, edit the
.theme-doc-toc-desktop::beforeselector. You can modify thecontent,font-family,font-size,font-weight, and other properties. -
Link Styles: Customize the appearance of the table of contents links by modifying the
.table-of-contents__linkselector. You can change thecolor,font-family,font-size, and other properties. -
Hover and Active States: Adjust the styles for hover and active states by editing the
.table-of-contents__link:hover,.table-of-contents__link--active, and related selectors. You can change colors, add underlines, or apply other effects. -
Visual Indicators for Active Links: Uncomment and modify the
.table-of-contents__link--active::beforeselector to add a visual indicator (like a border) for the currently active link. -
Backdrop Filters: If you want to apply backdrop filters to create a frosted glass effect, uncomment and customize the
[data-theme="light"] .table-of-contentsand[data-theme="dark"] .table-of-contentsselectors. Adjust thebackdrop-filter,background-color, and other properties as needed.
Remember to test your changes in both light and dark themes to ensure consistency and readability across different color schemes.
The sidebar.scss file is a crucial component of the Docusaurus template's styling system. It primarily focuses on customizing the appearance and behavior of the sidebar, navigation menu, and related elements. This file uses SCSS (Sassy CSS) to define styles for various classes and elements, ensuring a consistent and visually appealing sidebar across the documentation site.
Key features of this file include:
- Styling for active menu links
- Custom font settings for menu items
- Dark theme adaptations
- Customization of dropdown carets
- Removal of default borders
- Mobile-specific adjustments
- Breadcrumb styling
To customize the sidebar.scss file for your specific needs, you can make the following adjustments:
-
Colors: Replace color values (e.g.,
#313032,#A2A1A5,#0D0D0D) with your preferred color scheme. You can also modify the$color-1variable in thedesign-preferences.scssfile to change the primary color used throughout the sidebar. -
Fonts: Adjust the font family, size, weight, and other properties to match your desired typography. For example:
.menu__link { font-family: YourPreferredFont, sans-serif; font-size: 16px; font-weight: 400; }
-
Active link styles: Modify the appearance of active menu items by changing the
menu__link--activeclass properties. You can adjust the background, color, and border-radius to suit your design. -
Dark theme: Customize the dark theme colors by modifying the styles under the
[data-theme="dark"]selectors. -
Dropdown carets: Replace the SVG content in the
backgroundproperty of.menu__link--sublist-caret:after, .menu__caret:beforeto change the dropdown icon. -
Breadcrumbs: Adjust the breadcrumb styles, including colors, font weights, and visibility of specific items.
-
Mobile menu: Customize the mobile menu appearance by modifying the styles for
.navbar-sidebar__backand.navbar-toggle. -
Scrollbar: If you want to display the scrollbar for the table of contents, remove or modify the
.theme-doc-toc-desktop::-webkit-scrollbar-trackrule.
Remember to test your changes across different screen sizes and both light and dark themes to ensure a consistent user experience. If you need to make more extensive changes, consider creating additional SCSS files and importing them into your main stylesheet.
The shadcn.scss file is a crucial component of the Docusaurus template, combining Tailwind CSS utility classes with custom CSS variables for theming. It defines the color scheme and styling for both light and dark modes, ensuring a consistent and customizable appearance across the documentation site.
Key features of this file include:
- Tailwind CSS directives
- CSS custom properties (variables) for theming
- Dark mode support
- Base styles for HTML elements
- Custom styles for Markdown content and Docusaurus-specific elements
To customize the shadcn.scss file for your specific needs, you can follow these steps:
-
Adjust color scheme: Modify the CSS custom properties in the
:rootand.darkselectors to change the color palette for light and dark modes. For example::root { --primary: 210 50% 20%; // Change primary color --accent: 150 60% 50%; // Change accent color }
-
Customize typography: Add or modify typography-related CSS variables to change font styles, sizes, or weights.
-
Modify component styles: Adjust the existing styles or add new ones for specific components or elements. For instance:
.markdown { h1 { @apply text-3xl font-bold mb-4; } }
-
Add custom classes: Create new utility classes or component styles to use throughout your documentation:
.custom-button { @apply bg-primary text-white px-4 py-2 rounded-md; }
-
Override Docusaurus defaults: If you need to change specific Docusaurus styling, target the appropriate selectors and apply your custom styles:
#__docusaurus_skipToContent_fallback { // Your custom styles here }
-
Extend Tailwind configuration: If you need additional Tailwind utilities, you can extend the Tailwind configuration in your
tailwind.config.jsfile and use the new classes in this SCSS file.
Remember to test your changes in both light and dark modes to ensure consistency across your documentation site. After making changes, rebuild your Docusaurus site to see the updates take effect.
The secondaryColors.scss file is a SASS stylesheet that defines a set of secondary color variables for use in your Docusaurus template. It provides a comprehensive color palette with various shades and tints for four main colors:
- A pink/magenta color (color-2)
- A blue color (color-3)
- A brown/terra cotta color (color-4)
- Another blue color (color-5, identical to color-3)
Each main color has 12 variations, ranging from lighter tints to darker shades. These are numbered from 1 (lightest) to 12 (darkest), with the main color typically being the 5th or 6th variation.
To customize the secondaryColors.scss file for your specific needs:
-
Modify existing colors: You can adjust the RGB values of the main colors (color-2, color-3, color-4, color-5) to match your brand or design preferences.
$color-2: rgba(199, 21, 133, 1); // Change these values $color-3: rgba(30, 144, 255, 1); $color-4: rgba(160, 79, 49, 1); $color-5: rgba(30, 144, 255, 1);
-
Adjust color variations: You can fine-tune the tints and shades for each main color by modifying the hex values of their variations.
$color-2-1: #fe58b5; // Lightest tint $color-2-2: #ef48a7; // ... $color-2-12: #5d002f; // Darkest shade
-
Add new color sets: If you need additional color palettes, you can add new color sets following the same pattern:
$color-6: rgba(R, G, B, 1); $color-6-1: #hexvalue; $color-6-2: #hexvalue; // ... and so on
-
Remove unused colors: If you don't need all four color sets, you can remove the unused ones to keep your stylesheet lean.
-
Rename variables: You might want to give more meaningful names to the color variables based on their purpose in your design:
$primary-pink: rgba(199, 21, 133, 1); $primary-pink-light: #fe58b5; $primary-pink-dark: #5d002f;
Remember to update any references to these color variables in your other SCSS or CSS files after making changes. This will ensure consistency throughout your Docusaurus template.
The searchbar.scss file is a crucial component of the Docusaurus template's styling, specifically focusing on the search bar functionality and its responsive design. This SCSS file contains styles that control the appearance and behavior of the search bar across different screen sizes and themes (light and dark mode).
Key features of this file include:
- Centering and positioning of the search bar
- Responsive design for various screen sizes (mobile, tablet, desktop)
- Customization of the search button appearance
- Theme-specific styling for light and dark modes
- Z-index management for proper layering of UI elements
To customize the searchbar.scss file for your specific needs, you can make the following adjustments:
-
Search Bar Positioning: Modify the
.centerSearchBarclass to change the position and layout of the search bar. Adjust thetop,right,bottom, andleftproperties as needed..centerSearchBar { // Modify these values to change the position top: 10px; right: 20px; // ... }
-
Responsive Breakpoints: Adjust the media query breakpoints to match your desired responsive behavior. Current breakpoints are set at 600px, 967px, and 996px.
@media (max-width: 768px) { // Add your custom styles for tablets }
-
Search Button Styling: Customize the appearance of the search button by modifying the
.navbar .aa-DetachedSearchButtonclass. You can change the border color, background, and dimensions..navbar .aa-DetachedSearchButton { border: 2px solid your-color !important; background: your-background-color !important; // ... }
-
Theme-Specific Colors: Adjust the colors for light and dark themes by modifying the
[data-theme='light']selectors. You can change text colors, background colors, and other theme-specific properties.[data-theme='light'] .navbar-sidebar__back { color: your-light-theme-color !important; }
-
Z-index Adjustments: If you're having issues with element stacking, you can modify the z-index values to ensure proper layering of UI components.
.navbar-sidebar { z-index: your-desired-value !important; }
-
Mobile-Specific Styles: Customize the mobile view by modifying the styles within the smaller screen size media queries (e.g.,
@media (max-width: 600px)).
Remember to test your changes across different screen sizes and both light and dark themes to ensure a consistent user experience. After making modifications, rebuild your Docusaurus project to see the changes take effect.
The root-and-body.scss file is a crucial part of the Docusaurus template's styling system. It defines CSS variables and styles that control the overall appearance of the website, including color schemes for both light and dark themes, background gradients, and various layout adjustments.
Key features of this file include:
- Definition of color variables for primary colors and their variations
- CSS custom properties for Docusaurus theming
- Separate styles for light and dark themes
- Animated background gradients
- Styling for specific Docusaurus elements and classes
- Responsive design adjustments
To customize the root-and-body.scss file for your specific needs, you can make the following adjustments:
-
Color Scheme:
- Modify the
$color-1variable and its variations to change the primary color of your site. - Adjust the CSS custom properties in the
:rootand[data-theme="dark"]selectors to fine-tune the color palette for both light and dark themes.
$primary: $color-1; // Modify other color variables as needed :root { --ifm-color-primary: #{$color-1}; // Adjust other custom properties }
- Modify the
-
Background Gradients:
- Customize the radial gradients in the
[data-theme="dark"]and[data-theme="light"]selectors to create unique background effects. - Modify the
gradientAnimationkeyframes to change the animation behavior.
[data-theme="dark"] #__docusaurus::before { background: radial-gradient(ellipse 349px 354px at 60% 40%, rgba(#YourColor, var(--ellipis-transparency)) 40%, transparent 90%) no-repeat; // Adjust other properties as needed }
- Customize the radial gradients in the
-
Layout Adjustments:
- Modify the media queries and their associated styles to adjust the layout for different screen sizes.
- Customize padding, margins, and other layout properties to fit your design preferences.
[class^="docRoot"] { @media (min-width: 1400px) { padding-left: 5em; padding-right: 5em; padding-top: 2em; } // Add or modify other styles }
-
Element-Specific Styling:
- Add or modify styles for specific elements or classes to customize their appearance.
- For example, you can adjust the styling for images within documentation:
[class^="docRoot"] { img { margin-top: 1.5em; margin-bottom: 1.5em; // Add other image-specific styles } }
-
Animation and Effects:
- Modify the
backdrop-filterand-webkit-backdrop-filterproperties to adjust blur and saturation effects. - Customize the
animationproperty to change the duration or timing function of gradient animations.
- Modify the
Remember to test your changes thoroughly across different themes and screen sizes to ensure a consistent and appealing design throughout your Docusaurus site.
The prose.scss file is a crucial part of the styling for the ProseMirror editor in this Docusaurus template. It defines the appearance and layout of various elements within the editor, including tables, code blocks, images, and more. The file also includes responsive design elements for mobile devices.
Key features of this stylesheet include:
- Table styling with cell selection and column resizing
- Code and pre-formatted text appearance
- Image sizing and responsive behavior
- Blockquote and horizontal rule styling
- Column layout for content blocks
- Draggable item styling
- Responsive design adjustments for mobile devices
To customize the prose.scss file for your specific needs, you can modify various aspects of the stylesheet:
-
Table styling: Adjust the border colors, cell padding, or background colors in the
.ProseMirror tablesection. -
Typography: Modify the margins, padding, or font styles for elements like paragraphs, lists, and headings.
-
Code blocks: Change the background color, font family, or text color for inline code and code blocks in the
codeandpresections. -
Images: Adjust the
max-widthandheightproperties in theimgselector to control image sizing. -
Blockquotes: Customize the appearance of blockquotes by modifying the
padding-leftandborder-leftproperties. -
Column layout: Adjust the
gap,padding, orborderproperties in the.ProseMirror .column-blockand.ProseMirror .columnsections to change the appearance of column layouts. -
Draggable items: Modify the styling of draggable items by adjusting properties in the
.draggable-itemsection. -
Responsive design: Customize the mobile layout by modifying the media queries at the bottom of the file. You can adjust breakpoints, change the layout, or modify font sizes for smaller screens.
-
Custom elements: Add new selectors and styles for any custom elements or plugins you may add to the ProseMirror editor.
To implement your changes, simply edit the prose.scss file and adjust the CSS properties as needed. Remember to rebuild your project after making changes to see the updates in your Docusaurus site.
The prose-table.scss file is a SCSS stylesheet that defines the styling for tables and other elements within the ProseMirror editor. This file is part of an open-source Docusaurus template and is responsible for the visual appearance of content created using the ProseMirror rich text editor.
Key features of this stylesheet include:
- Table styling with fixed layout and border collapse
- Cell styling for both regular and header cells
- Highlighting for selected cells
- Column resize handle styling
- Basic typography adjustments for various elements (paragraphs, lists, code blocks, images, blockquotes, and horizontal rules)
To customize the prose-table.scss file for your specific use case, you can modify various aspects of the styling. Here are some ways you can adapt the styles:
-
Table appearance:
- Adjust the
borderproperty oftdandthelements to change the border style, color, or width. - Modify the
paddingvalues to increase or decrease cell spacing. - Change the
background-colorofthelements to use a different color for table headers.
- Adjust the
-
Selected cell highlighting:
- Customize the
backgroundcolor and opacity of the.selectedCell:afterpseudo-element to change the appearance of selected cells.
- Customize the
-
Column resize handle:
- Modify the
width,background-color, orrightposition of the.column-resize-handleto adjust its appearance or position.
- Modify the
-
Typography:
- Change the
margin-topvalue of> * + *to adjust the spacing between elements. - Modify the
paddingofulandolelements to adjust list indentation.
- Change the
-
Code blocks:
- Customize the
background-colorandcolorofpreelements to change the appearance of code blocks. - Adjust the
font-familyto use a different monospace font for code.
- Customize the
-
Blockquotes:
- Modify the
border-leftproperty ofblockquoteelements to change the style of the left border.
- Modify the
-
Horizontal rules:
- Adjust the
border-topproperty ofhrelements to change the appearance of horizontal rules.
- Adjust the
To implement these customizations, open the prose-table.scss file and modify the relevant CSS properties. After making your changes, make sure to rebuild your Docusaurus project to apply the updated styles.
Remember to test your changes thoroughly to ensure they don't negatively impact the functionality or appearance of the ProseMirror editor in your Docusaurus template.
The navbar.scss file is a crucial component of the open-source Docusaurus template, responsible for styling the navigation bar. It provides custom styles for both light and dark themes, implements a fixed-top navbar, and includes responsive design elements.
Key features of this file include:
- Theme-specific styles for light and dark modes
- Sticky positioning for the navbar
- Blur effect for the navbar background
- Custom styling for theme toggle buttons
- Responsive design adjustments
To customize the navbar.scss file for your specific needs, consider the following approaches:
-
Adjust color schemes: Modify the background colors and text colors for both light and dark themes to match your brand identity.
[data-theme="dark"] .navbar--fixed-top { background-color: rgb(8 28 69 / 30%); color: white; } [data-theme="light"] .navbar--fixed-top { background-color: rgba(255, 255, 255, 0.34); color: black; }
-
Customize navbar height: Change the height of the navbar by modifying the
heightproperty..navbar--fixed-top { height: 4.375rem; // Adjust this value as needed }
-
Modify blur effect: Adjust the blur intensity and saturation of the navbar background.
.navbar--fixed-top { backdrop-filter: blur(16px) saturate(180%); -webkit-backdrop-filter: blur(16px) saturate(180%); }
-
Update theme toggle buttons: Replace the SVG images for the theme toggle buttons with your own custom icons.
[data-theme="dark"] .navbar__items--right { [class^="toggle"] { .clean-btn { background-image: url("path/to/your/dark-theme-icon.svg") !important; } } } .navbar__items--right { [class^="toggle"] { .clean-btn { background-image: url("path/to/your/light-theme-icon.svg"); } } }
-
Adjust responsive breakpoints: Modify the media queries to better suit your design needs.
@media (min-width: 1400px) { .navbar { padding-left: 2em; padding-right: 2em; } } @media (max-width: 767px) { .navbar__title { display: none !important; } }
-
Customize logo dimensions: Adjust the minimum width and height of the navbar logo.
.navbar__logo { min-width: 1.84588rem; min-height: 1.6875rem; }
Remember to test your changes across different screen sizes and themes to ensure a consistent user experience. You may also need to update corresponding HTML and JavaScript files if you make significant changes to the navbar structure or functionality.
The mobilelanding.scss file is a crucial part of the responsive design for the Dev-Docs landing page. It contains styles specifically tailored for mobile devices with a maximum width of 767px. This file adjusts various elements of the landing page to ensure optimal display and functionality on smaller screens.
Key features of this stylesheet include:
- Responsive layout adjustments for the main content area
- Mobile-specific styling for headings, buttons, and grid layouts
- Custom styles for hero sections and integration grids
- Font size and spacing modifications for better readability on small screens
- Hiding certain elements that may not be suitable for mobile view
To customize the mobilelanding.scss file for your specific needs, consider the following approaches:
-
Adjust breakpoints: The current breakpoint is set to 767px. You can modify this value to target different screen sizes:
@media (max-width: 767px) { // Your styles here }
-
Customize typography: Modify font sizes, weights, and styles to match your brand:
h1 { font-size: 2.5rem; font-weight: 700; font-family: 'Your-Preferred-Font', sans-serif; }
-
Modify color scheme: Replace color values with your own brand colors:
.main-btn { border: 2px solid #your-color; background: #your-background-color; }
-
Adjust layout and spacing: Modify padding, margins, and flex properties to fit your design:
.dev-docs-landing { min-height: 320ch; display: flex; justify-content: flex-start; align-items: flex-start; }
-
Customize hero sections: Modify background images, colors, and content layout for each hero section:
.second-hero { background-image: url("/path/to/your/image.png"); background-position: top left; background-repeat: no-repeat; }
-
Adjust or remove specific components: You can modify or remove styles for components that don't fit your needs, such as the integration grid or draggable elements.
Remember to test your changes across various mobile devices and screen sizes to ensure a consistent user experience. You may also want to use CSS variables for colors and sizes to make global changes easier to manage.
The legacy.scss file is a crucial component of the open-source Docusaurus template. It contains various SCSS styles that define the appearance and behavior of different elements in the template. This file includes styles for cards, buttons, tables, and responsive design elements.
Key features of this file include:
- Styling for different types of cards (e.g., magic cards, gradient hover cards)
- Button styles with gradient effects
- Table styling
- Responsive design adjustments
- Custom animations
- Utility classes for extending width and height
To customize the legacy.scss file for your specific use case, you can follow these steps:
-
Color Scheme: Modify the color variables (e.g.,
$color-1,$color-2, etc.) to match your brand's color scheme.$color-1: #your-color-here; $color-2: #your-color-here; // ... and so on
-
Card Styles: Adjust the card styles by modifying classes like
.magic-card,.gradient-hover-card-one, etc. You can change properties such asborder-radius,padding, orbox-shadow..gradient-hover-card-one { border-radius: 20px; // Change the border radius padding: 40px 20px; // Adjust padding // Add or modify other properties }
-
Button Styles: Customize button appearances by modifying classes like
.button,.border-button, or.gradient-button..gradient-button { background-image: linear-gradient(to right, #your-color-1, #your-color-2); // Modify other properties as needed }
-
Responsive Design: Adjust the media queries to fit your specific breakpoints and modify the styles for different screen sizes.
@media (max-width: 768px) { // Your custom styles for mobile devices } @media (max-width: 1024px) { // Your custom styles for tablets }
-
Custom Animations: Modify existing animations or add new ones to suit your needs.
@keyframes your-custom-animation { 0% { /* start state */ } 100% { /* end state */ } }
-
Typography: Adjust font sizes, line heights, and letter spacing to match your design preferences.
.your-text-class { font-size: 16px; line-height: 1.5; letter-spacing: 0.5px; }
-
Utility Classes: Add or modify utility classes to extend functionality.
.your-custom-utility-class { // Your custom styles }
Remember to test your changes thoroughly across different devices and browsers to ensure compatibility and responsiveness. If you're not familiar with SCSS, consider learning its basics to take full advantage of its features like variables, mixins, and nesting.
The landingpage.scss file is a crucial component of the styling for the landing page in this Docusaurus template. It contains a variety of CSS styles that define the look and feel of the landing page, including layout, typography, color schemes, and responsive design elements.
Key features of this stylesheet include:
- Responsive design for various screen sizes
- Custom styling for headings, paragraphs, and other text elements
- Glassmorphism effects for certain UI components
- Dark and light theme support
- Custom styles for draggable items and grid layouts
- Specific styling for hero sections and contact forms
To customize the landingpage.scss file for your specific needs, you can follow these steps:
-
Color Scheme: Modify the color variables to match your brand's color palette. Look for color definitions like
#cecef8,#a4fad1, etc., and replace them with your preferred colors. -
Typography: Adjust font sizes, weights, and families to align with your design preferences. For example:
h1 { font-size: 4.88313rem; font-family: YourPreferredFont, sans-serif; font-weight: 700; }
-
Layout: Modify the layout properties such as padding, margins, and grid settings to fit your content structure. For instance:
.content { padding-left: 5em; padding-right: 5em; max-width: 90%; }
-
Responsive Design: Adjust the media queries to ensure your landing page looks great on all devices. You can modify existing breakpoints or add new ones:
@media (max-width: 992px) { // Your custom styles for tablets }
-
Custom Components: Add or modify styles for specific components you've created. For example:
.my-custom-component { background-color: #f0f0f0; border-radius: 8px; padding: 1rem; }
-
Theme Customization: Modify the dark and light theme styles to match your preferences:
[data-theme="dark"] { // Your custom dark theme styles } [data-theme="light"] { // Your custom light theme styles }
-
Effects and Animations: Customize or add new effects like the glassmorphism style:
.glass-effect { backdrop-filter: blur(10px); background-color: rgba(255, 255, 255, 0.1); }
Remember to test your changes across different browsers and devices to ensure compatibility and responsiveness. You may also want to use CSS preprocessor features like variables and mixins to make your customizations more maintainable.
This SCSS file defines styling for headings, paragraphs, and other text elements in a Docusaurus template. It includes styles for both light and dark themes, as well as responsive typography and consistent spacing.
Key features:
- Theme-specific styles for light and dark modes
- Consistent typography for headings (h1-h6) and paragraphs
- Responsive font sizes and weights
- Uniform spacing using a base margin and vertical margin mixin
- Styles for lists, images, and links
-
Modify theme colors:
- Adjust the color values in the
[data-theme="dark"]and[data-theme="light"]sections to match your brand colors.
- Adjust the color values in the
-
Change font families:
- Replace the
font-familydeclarations with your preferred fonts. You can use system fonts, web fonts, or custom fonts.
- Replace the
-
Adjust typography:
- Modify the
font-size,font-weight,line-height, andletter-spacingproperties for headings and paragraphs to match your design requirements.
- Modify the
-
Customize spacing:
- Change the
$base-marginvalue to increase or decrease the overall spacing between elements. - Adjust the multipliers in the
vertical-marginmixin calls to fine-tune spacing for specific heading levels.
- Change the
-
Modify link styles:
- Update the
aanda:hoverselectors to change link colors and hover effects.
- Update the
-
Add custom classes:
- Create new class selectors for specific elements or components in your documentation.
-
Responsive design:
- Add media queries to adjust styles for different screen sizes.
-
Extend existing styles:
- Use SCSS nesting and extend features to add more specific styles while maintaining the base design.
Example customization:
// Custom color variable
$brand-primary: #3498db;
[data-theme="light"] {
h1, h2, h3, h4, h5, h6 {
color: $brand-primary !important;
}
}
// Custom heading style
h1 {
font-size: 36px;
text-transform: uppercase;
}
// Responsive font size
@media (max-width: 768px) {
h1 {
font-size: 28px;
}
}Remember to test your changes across different themes and screen sizes to ensure consistency and readability throughout your documentation.
The footer.scss file is a crucial component of the Docusaurus template, responsible for styling the footer section of the website. It contains SCSS code that defines the appearance and layout of various footer elements, including social media icons, pagination navigation, and copyright information.
Key features of this stylesheet include:
- Theme-specific styling for dark and light modes
- Custom styling for pagination navigation links
- Social media icon implementations (GitHub, Instagram, Discord, LinkedIn)
- Footer layout and alignment adjustments
- Responsive design considerations
To customize the footer styles for your specific needs, you can modify the footer.scss file in the following ways:
-
Adjust theme-specific styles: Modify the styles within
[data-theme="dark"]and[data-theme="light"]selectors to change the appearance of the footer in different color modes.[data-theme="dark"] .footer--dark { // Your custom dark mode styles } [data-theme="light"] .footer--dark { // Your custom light mode styles }
-
Customize pagination navigation: Modify the
.pagination-nav__linkand related classes to change the appearance of the "Previous" and "Next" navigation buttons..pagination-nav__link { // Your custom styles for navigation links }
-
Update social media icons: Add or remove social media icons by modifying the respective classes (e.g.,
.github,.instagram,.discord,.linkedin). You can also change the icon sizes or add new icons:.new-social-icon { width: 24px; height: 24px; background-image: url("/path/to/your/icon.svg"); // Other necessary styles }
-
Adjust footer layout: Modify the
.footer,.container-fluid, and.row.footer__linksclasses to change the overall layout and spacing of the footer elements:.footer { // Your custom footer styles } .container-fluid { // Adjust max-width or other properties } .row.footer__links { // Modify the layout of footer links }
-
Customize typography: Update font styles for various footer elements, such as the copyright text:
.footer__copyright { font-family: YourPreferredFont, sans-serif; font-size: 12px; // Other typography styles }
-
Add responsive styles: Implement media queries to ensure the footer looks good on different screen sizes:
@media (max-width: 768px) { .footer { // Styles for smaller screens } }
Remember to test your changes across different browsers and devices to ensure consistency and proper functionality. If you're using CSS modules or a different styling approach in your Docusaurus setup, you may need to adjust the selectors or import statements accordingly.
The design-preferences.scss file is a crucial component of the open-source Docusaurus template's styling system. It defines a comprehensive color palette using SCSS variables, allowing for easy customization and consistent theming across the project.
This file contains five main color sets (color-1 to color-5), each with a base color and 12 variations. These color sets provide a wide range of shades that can be used throughout the template for various UI elements, ensuring a cohesive and visually appealing design.
To customize the design-preferences.scss file for your specific use case, follow these steps:
-
Modify base colors:
- Locate the base color variables (e.g.,
$color-1,$color-2, etc.). - Replace the hexadecimal or rgba values with your desired colors.
- Locate the base color variables (e.g.,
-
Adjust color variations:
- For each base color, there are 12 variations (e.g.,
$color-1-1to$color-1-12). - You can modify these variations to create your own custom color palette.
- Ensure a good contrast ratio between variations for accessibility.
- For each base color, there are 12 variations (e.g.,
-
Add new color sets:
- If needed, you can add new color sets by following the existing pattern.
- For example, you could add
$color-6and its variations.
-
Use variables in your styles:
- In your other SCSS or CSS files, use these color variables to maintain consistency.
- For example:
background-color: $color-1-3;
-
Consider creating theme variations:
- You could create multiple versions of this file for different themes (e.g., light and dark modes).
-
Document your changes:
- Add comments to explain the purpose of each color or any specific usage guidelines.
-
Test your changes:
- After modifying the colors, thoroughly test your site to ensure all elements look as intended with the new color scheme.
By customizing this file, you can easily adapt the template's color scheme to match your brand or design preferences, ensuring a unique and cohesive look for your Docusaurus site.
The custom.scss file is a central stylesheet for a Docusaurus-based project. It imports various SCSS modules and Tailwind CSS utilities to provide a comprehensive styling foundation for the entire site. This file acts as the main entry point for all custom styles and design preferences.
Key components imported in this file include:
- Tailwind CSS base, components, and utilities
- Custom design preferences and secondary colors
- Component-specific styles (e.g., sidebar, navbar, footer)
- Typography styles for headings, paragraphs, and prose
- Styles for specific features like the searchbar, table of contents, and chatbot
- Styles for different page types (e.g., landing page, blog, cards)
To customize the custom.scss file for your specific needs:
-
Tailwind CSS customization:
- Modify the Tailwind configuration file to change default styles, add new utility classes, or extend existing ones.
-
Design preferences:
- Edit the
design-preferences.scssandsecondaryColors.scssfiles to adjust color schemes, fonts, and other global design elements.
- Edit the
-
Component-specific styles:
- Modify or create new SCSS files for individual components (e.g.,
sidebar.scss,navbar.scss) to customize their appearance.
- Modify or create new SCSS files for individual components (e.g.,
-
Typography:
- Adjust
headings-and-paragraphs.scssandprose.scssto fine-tune text styles across your site.
- Adjust
-
Feature-specific styles:
- Customize styles for specific features by modifying files like
searchbar.scss,table-of-contents.scss, orchatbot.scss.
- Customize styles for specific features by modifying files like
-
Page-type styles:
- Tailor the appearance of different page types by editing files such as
landingpage.scss,blog.scss, orcards.scss.
- Tailor the appearance of different page types by editing files such as
-
Add new imports:
- Create and import new SCSS modules for additional custom styles or components specific to your project.
-
Remove unused imports:
- If certain features or components are not used in your project, you can remove their corresponding import statements to reduce the file size.
-
Order of imports:
- Adjust the order of imports if you need to override specific styles or ensure proper cascading of CSS rules.
Remember to rebuild your project after making changes to see the effects of your customizations.
This file, custom.css, is a crucial part of the Docusaurus template's styling system. It imports the core Tailwind CSS modules, which provide a utility-first CSS framework. This approach allows for rapid UI development with pre-defined classes.
The file consists of three main imports:
@import 'tailwindcss/base';@import 'tailwindcss/components';@import 'tailwindcss/utilities';
These imports bring in the base styles, component styles, and utility classes from Tailwind CSS, respectively.
To customize the custom.css file for your specific needs, you can:
-
Add custom CSS rules: You can add your own CSS rules below the Tailwind imports. These will override or complement the Tailwind styles.
@import 'tailwindcss/base'; @import 'tailwindcss/components'; @import 'tailwindcss/utilities'; /* Your custom CSS here */ .my-custom-class { color: #ff0000; }
-
Extend Tailwind's configuration: In your
tailwind.config.jsfile, you can extend or override Tailwind's default theme, add new utility classes, or configure plugins.module.exports = { theme: { extend: { colors: { 'custom-blue': '#1da1f2', }, }, }, // ... other configurations };
-
Use Tailwind's @apply directive: You can use Tailwind's utility classes within your custom CSS using the
@applydirective..btn-primary { @apply py-2 px-4 bg-blue-500 text-white font-semibold rounded-lg shadow-md hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-400 focus:ring-opacity-75; }
-
Import additional CSS files: If you have other CSS files for specific components or pages, you can import them in this file.
@import 'tailwindcss/base'; @import 'tailwindcss/components'; @import 'tailwindcss/utilities'; @import './my-component-styles.css'; @import './my-page-styles.css';
Remember to rebuild your project after making changes to see the effects of your customizations.
The custom-templates.scss file is part of an open-source Docusaurus template. It contains custom SCSS styles that define various visual elements and layouts used throughout the template. These styles are designed to enhance the appearance and functionality of the template, providing a range of customizable components such as cards, grids, and responsive designs.
Key features of this stylesheet include:
- Responsive grid layouts
- Custom card designs with hover effects
- Glassmorphism effects
- Gradient animations
- Media queries for different screen sizes
- Syntax highlighting for code blocks
- Custom table styles
To customize the custom-templates.scss file for your specific needs, you can follow these steps:
-
Color Scheme:
- Look for color variables (e.g.,
$color-1,$color-2, etc.) and modify them to match your desired color scheme. - Update gradient colors in various classes like
.gradient-hover-card-one,.gradient-hover-card-two, etc.
- Look for color variables (e.g.,
-
Card Styles:
- Modify classes like
.general-card,.glass-card-one,.gradient-hover-card-one, etc., to change the appearance of different card types. - Adjust padding, border-radius, and box-shadow properties to alter the card design.
- Modify classes like
-
Grid Layouts:
- Customize the
.draggable-gridand.draggable-logo-gridclasses to change the layout of grid elements. - Modify
flexproperties andgapvalues to adjust spacing and sizing.
- Customize the
-
Responsive Design:
- Edit the media queries (
@media (max-width: 768px)and@media (max-width: 1024px)) to adjust the responsive behavior for different screen sizes. - Modify properties like
flex,height, andpaddingwithin these media queries to fine-tune the mobile and tablet layouts.
- Edit the media queries (
-
Typography:
- Adjust font sizes, line heights, and letter spacing in various classes to match your typography preferences.
-
Animations:
- Modify the
@keyframes rotationand@keyframes rotaterules to change animation behaviors. - Adjust animation properties in classes like
.gradient-hover-card-one:hover::beforeto alter hover effects.
- Modify the
-
Code Highlighting:
- Customize the colors in the
.ProseMirror presection to change the appearance of syntax highlighting in code blocks.
- Customize the colors in the
-
Custom Components:
- Add new classes or modify existing ones like
.callout,.background-landing, or.radial-card-contentto create or adjust custom components.
- Add new classes or modify existing ones like
Remember to test your changes thoroughly across different devices and browsers to ensure compatibility and desired appearance. You may also want to use CSS preprocessing tools to take full advantage of SCSS features like variables and mixins for more efficient customization.
The coding-languages.scss file is a Sass (SCSS) stylesheet that contains styling rules for specific language-related elements in a Docusaurus template. This file focuses on the appearance of Markdown language elements within the documentation.
The file currently contains a single rule set for the .language-markdown class, which is likely used to style code blocks or inline code snippets that contain Markdown syntax.
To customize the coding-languages.scss file for your specific needs, you can modify the existing rules or add new ones. Here are some ways you can adapt this file:
-
Adjust the
.language-markdownclass:- Change the
opacityvalue to make Markdown syntax more or less visible. - Modify the
heightandwidthproperties to alter the size of Markdown code blocks. - Adjust the
overflowproperty to change how content behaves when it exceeds the container's dimensions.
- Change the
-
Add styles for other language classes:
- Create new rule sets for other language-specific classes, such as
.language-javascript,.language-python, etc. - Example:
.language-javascript { background-color: #f7df1e; color: #000000; }
- Create new rule sets for other language-specific classes, such as
-
Implement syntax highlighting:
- Add rules to highlight different parts of the code syntax, such as keywords, strings, or comments.
- Example:
.language-markdown { .keyword { color: #0000ff; } .string { color: #008000; } }
-
Create a common style for all code blocks:
- Use a more general selector to apply styles to all language classes.
- Example:
[class^="language-"] { font-family: 'Courier New', Courier, monospace; border-radius: 4px; padding: 1em; }
-
Add responsive designs:
- Use media queries to adjust the appearance of code blocks on different screen sizes.
- Example:
@media (max-width: 768px) { .language-markdown { width: 100%; height: auto; } }
Remember to test your changes thoroughly to ensure they work well with your Docusaurus template and provide a good user experience across different devices and browsers.
The chatbot.scss file contains styling for a chat interface, likely used in a Docusaurus-based website. This file defines the appearance and layout of various chat components, including the chat box, messages, input fields, and toggle buttons. It also includes responsive design adjustments for different screen sizes and supports both light and dark themes.
Key features of this stylesheet include:
- Styling for a fixed-position chat box
- Message bubble designs for user and bot messages
- Loading animation for pending messages
- Responsive design for mobile and tablet devices
- Theme-specific styles for light and dark modes
- Fullscreen chat mode
- Styling for code blocks within chat messages
To customize the chat interface for your specific needs, you can modify various aspects of the chatbot.scss file:
-
Colors and Theme:
- Adjust the color scheme by modifying color values throughout the file.
- Customize the
[data-theme="dark"]and[data-theme="light"]selectors to fine-tune the appearance for different themes.
-
Layout and Positioning:
- Change the
position,bottom,right,width, andheightproperties of the.chat-boxclass to adjust the chat box's size and position. - Modify the
border-radiusvalues to change the roundness of various elements.
- Change the
-
Typography:
- Update
font-family,font-size,font-weight, and other text-related properties to match your preferred typography.
- Update
-
Responsive Design:
- Adjust the media queries at the bottom of the file to fine-tune the layout for different screen sizes.
-
Chat Messages:
- Customize the
.user-messageand.bot-messageclasses to change the appearance of chat bubbles. - Modify the
.loading-dotsanimation for a different loading indicator.
- Customize the
-
Input and Buttons:
- Update the
.chat-box__inputand.chat-box__buttonclasses to style the input field and send button.
- Update the
-
Special Features:
- Customize the
.full-screenclass to change how the chat box appears in fullscreen mode. - Modify the
.copy-buttonclass to adjust the appearance of the code copy button.
- Customize the
-
Animations:
- Adjust the
transitionproperties and@keyframesdefinitions to change animations and transitions.
- Adjust the
Remember to test your changes across different devices and themes to ensure a consistent user experience. You may also want to consider adding new classes or modifying existing ones to introduce additional features or styling options specific to your project's needs.
The cards.scss file is part of an open-source Docusaurus template. It contains SCSS styles that implement a glassmorphism effect for cards, specifically for the dark theme. This effect creates a semi-transparent, frosted glass appearance that can enhance the visual appeal of card components in your Docusaurus site.
The file uses the [data-theme="dark"] selector to apply these styles only when the dark theme is active. The glassmorphism effect is achieved through a combination of backdrop filters, background colors, and border properties.
To customize the glassmorphism card effect for your specific use case, you can modify the following properties within the .card class:
-
Blur and saturation: Adjust the
backdrop-filterand-webkit-backdrop-filtervalues to change the blur intensity and saturation. For example:backdrop-filter: blur(10px) saturate(180%); -webkit-backdrop-filter: blur(10px) saturate(180%);
-
Background color: Modify the
background-colorto change the card's base color and opacity:background-color: rgba(17, 25, 40, 0.75); -
Border radius: Adjust the
border-radiusto change the card's corner roundness:border-radius: 16px;
-
Border color and opacity: Modify the
borderproperty to change the card's border appearance:border: 1px solid rgba(255, 255, 255, 0.2); -
Light theme support: To add glassmorphism effects for the light theme, you can create a new selector outside the
[data-theme="dark"]block:[data-theme="light"] { .card { // Light theme glassmorphism styles } }
Remember to test your changes in different browsers, as some may not fully support backdrop filters. You may need to provide fallback styles for better cross-browser compatibility.
The blog.scss file is a crucial part of the Docusaurus template's styling system, specifically tailored for the blog section. It contains SCSS (Sassy CSS) code that defines the layout, appearance, and responsive behavior of various blog-related components.
Key features of this file include:
- Responsive design adjustments for different screen sizes
- Custom styling for blog post headers and content
- Layout modifications for both blog list and individual post pages
- Conditional styling based on theme (light/dark mode)
- Customizations for typography, spacing, and element visibility
To customize the blog.scss file for your specific needs, consider the following approaches:
-
Modify existing styles:
- Adjust color schemes, fonts, or spacing by changing values in the existing CSS rules.
- Example: To change the font size of blog post content, locate the
.dev-docs-blog pselector and modify thefont-sizeproperty.
-
Add new style rules:
- Create new CSS selectors to target specific elements in your blog layout.
- Example: To add a custom background to your blog sidebar, you could add:
.blog-sidebar { background-color: #f0f0f0; padding: 1rem; }
-
Responsive design adjustments:
- Modify or add media queries to fine-tune the layout for different screen sizes.
- Example: To adjust the blog header title for medium-sized screens, you could add:
@media (min-width: 768px) and (max-width: 1023px) { .blog-header-title-card h1 { font-size: 48px; } }
-
Conditional styling:
- Utilize the existing
conditional-stylesmixin or create your own to apply styles based on specific conditions. - Example: To hide a certain element only on the blog list page, you could add:
.blog-list-page { @include conditional-styles("some-class") { .element-to-hide { display: none; } } }
- Utilize the existing
-
Theme customization:
- Modify or add styles for dark mode by using the
[data-theme="dark"]selector. - Example: To change link colors in dark mode, you could add:
[data-theme="dark"] { .blog-content a { color: #00ffff; } }
- Modify or add styles for dark mode by using the
Remember to test your changes thoroughly across different devices and browsers to ensure a consistent experience for all users. You may also need to rebuild your Docusaurus site to see the changes take effect.