Skip to content

Commit

Permalink
Version 2.0.0 Refactor
Browse files Browse the repository at this point in the history
  • Loading branch information
Jieiku committed Aug 22, 2023
1 parent 2200308 commit 38d8844
Show file tree
Hide file tree
Showing 50 changed files with 2,031 additions and 3 deletions.
1 change: 1 addition & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
github: [Jieiku]
26 changes: 26 additions & 0 deletions .github/workflows/actions.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
name: Generate Sponsors README
on:
push:
branches:
- master
pull_request:
branches:
- master
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: Checkout 🛎️
uses: actions/checkout@v2

- name: Generate Sponsors 💖
uses: JamesIves/github-sponsors-readme-action@v1.0.8
with:
token: ${{ secrets.PAT }}
file: 'README.md'

- name: Deploy to GitHub Pages 🚀
uses: JamesIves/github-pages-deploy-action@v4
with:
branch: master
folder: '.'
11 changes: 11 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
.env
public
themes
build
storage
node_modules
static/demo.html
static/tinysearch_engine.js
static/tinysearch_engine.d.ts
static/tinysearch_engine_bg.wasm.d.ts
static/package.json
3 changes: 3 additions & 0 deletions .gitmodules
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[submodule "themes/abridge"]
path = themes/abridge
url = https://github.com/jieiku/abridge.git
Empty file added .nojekyll
Empty file.
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2022 Jake G
Copyright (c) 2022 Jake G (https://github.com/Jieiku)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
104 changes: 102 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,102 @@
# abridge.css
A classlight CSS utility for your HTML
<div align="center">
<img src="https://raw.githubusercontent.com/Jieiku/abridge.css/master/abridge.svg"/>

# Abridge CSS

Abridge.css is a CSS library for semantic html, it adds a nice default style for all HTML elements. This was originally created to be used as a classless or optionally class-light framework for a semantic html Zola Blog Theme. It can save you a lot of time when you need to style HTML for your HTML/React/Vue demo on CodePen/CodeSandbox. It can also be used as a base style for your blog/website.

Maintainence of this project is made possible by all the <a href="https://github.com/Jieiku/abridge.css/graphs/contributors">contributors</a> and <a href="https://github.com/sponsors/Jieiku">sponsors</a>. If you'd like to sponsor this project and have your avatar or company logo appear below <a href="https://github.com/sponsors/Jieiku">click here</a>. 💖

<!-- sponsors --><!-- sponsors -->

---

**[View demo](https://abridgecss.netlify.app/)**

</div>

Abridge CSS uses [normalize.css](https://github.com/necolas/normalize.css/) and [sanitize.css](https://github.com/csstools/sanitize.css) to ensure consistent styling across browsers (no IE support). When using Abridge CSS, you don't need to include `normalize.css` or `sanitize.css` anymore.

Abridge CSS uses CSS variables and is structured to be modular, so you can include only the parts that you need. There are three themes included: light, dark, and automatic. The automatic theme will display either a light or dark theme depending on the users browser preference setting. (prefers-color-scheme: dark)

Abridge CSS is very lightweight, and the size can be further tuned by including only what you plan to use.

In the `abridge.scss` you will find all of the imports, by default everything is enabled, except the icons which are disabled in the `_variables.scss` file, you can enable them as neeeded.

I created Abridge.css primarily to use with Zola, and because I was after a set of features: semantic/classless, dark mode, responsive text, Normalize, Sanitize, and overall small size. I researched various css frameworks prior to creating this framework: [tabulated comparison of css frameworks](https://github.com/Jieiku/classless-css/blob/master/README.md)

## Features:

- Drop in to use, no configuration.
- Class-light (there are very few classes)
- Consistent styling across browsers thanks to `normalize.css` and `sanitize.css`
- Responsive
- Supports light and dark themes (automatically detect the OS/browser mode and switch)
- Uses CSS variables
- Uses `rem`
- Lightweight
- Semantic

## Download

See [https://raw.githubusercontent.com/Jieiku/abridge.css/master/dist/abridge.css](https://raw.githubusercontent.com/Jieiku/abridge.css/master/dist/abridge.css)

## Customizing

Abridge SASS variables can be overrided by editing `sass\abridge.scss` file in your project's root sass folder.

### Page Width:

```scss
$mw:75%,// max-width
```

### Abridge Theme Modes

```scss
$abridgeMode: "switcher",//valid values: switcher, auto, dark, light
```

- Switcher automatically displays a dark or light version depending on browser/OS settings, and has a javascript user clickable theme switcher.
- Auto automatically displays a dark or light version depending on browser/OS settings.
- Dark is the dark theme always.
- Light is the light theme always.

### Colors and Styles

You can specify which color template you want to use as a base:
```scss
$color: "orange",// color template to use/override: orange, blue, blueshade
```

Then override individual colors as needed:
```scss
/// Dark Colors
$f1d: #ccc,// Font Color Primary
$f2d: #ddd,// Font Color Headers
$c1d: #111,// Background Color Primary
$c2d: #222,// Background Color Secondary
...
```

## Compiling:

install nodejs: https://nodejs.org/

```bash
git clone https://github.com/Jieiku/abridge.css
cd abridge.css
npm install sass
npm run-script main
```

## Credits
- [new.css](https://github.com/xz/new.css)
- [bamboo.css](https://github.com/rilwis/bamboo)
- [pico.css](https://github.com/picocss/pico)
- [Basic.css](https://github.com/vladocar/Basic.css)
- [AttriCSS](https://github.com/raj457036/attriCSS)
- [normalize.css](https://github.com/necolas/normalize.css)
- [sanitize.css](https://github.com/csstools/sanitize.css)
- [Feather Icons](https://github.com/feathericons/feather)
- [Tabler Icons](https://github.com/tabler/tabler-icons)
1 change: 1 addition & 0 deletions abridge.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 38d8844

Please sign in to comment.