Skip to content

glyphpoch/pbss

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pbss: Practically Better Style Sheets

Pbss is an attempt to improve on the Cascading Stylesheet Language by adding easier support for variables, arithmetic and providing additional features such as macros, functions and more. Plus it is a sort of linter that prevents your stylesheet from not working due to a tiny letter you typed by mistake. Specifically said it is a preprocessor for CSS similar to Sass and Less

Installation

It is very easy to get started with Pbss. First download the latest stable executable for your platform from the Pbss's release page. Usually they do have a version number such as Pbss-[major-version].0. Now follow these instructions for your Operating System.

Windows

  • Put the executable in a place that you like. For example C:\Users\[YOUR-USERNAME]\pbss.
  • Now open the start menu and type env in your search bar and clicking on Enviroment Variables
  • Select PATH from the items and click on edit.
  • Now add the the path to the folder where you stored the binary by adding a colon(:) and then putting the path to the directory

Linux

  • Put the executable in a place you like. Most Linux/UNIX users like to put binaries that are not installed from their official repos in a folder in their home directory named bin. But you can use anything
  • Now in most Linux distributions like Ubuntu if you used the bin directory, this should show allow you to run Pbss, after restarting your terminal, but if it doesn't add this line to any of your profile files, like .profile, .bashrc, .bash_profile, .zshrc, .zsh_profile
	export PATH="$PATH:$HOME/bin/"
  • This adds your home directory's bin folder to a variable called $PATH which is read by shells for getting program names. If you chose to use another directory, replace the contents after the color(:) with your own directory path

MacOS

  • Put the executable in a suitable directory like in your home directory's bin directory or you can crate a pbss directory
  • Add this to your .bashrc
	export PATH="$PATH:$HOME/bin/"
  • This adds your home directory's bin folder to a variable called $PATH which is read by shells for getting program names. If you chose to use another directory, replace the contents after the color(:) with your own directory path

Building From source

In order to build Pbss from source, make sure that you have fulfilled these requirements:-

  • Rust and Cargo >= 1.43.0

  • A linker, usually a C based compiler will fulfill this

  • Git

  • Clone the master branch using this command

	git clone https://arijit79/pbss.git
  • Now run this command
	cargo build --release
  • Now open the target folder. Inside it you will see the release folder. Now move the executable pbss depending on the steps of your OS defined above.

Getting started

To get started and learn about features supported in Pbss, check out the docs

The Move From Python to Rust

Pbss was initially written in Python but since version 1.it is being completely rewritten in the Rust language due to its grater efficiency and robustness. The move is still not complete although it is expected to be completed by the next major release. A few reasons for this move are

  • Rust is a compiled language which is helpful since it generates machine code making the distribution easier
  • Rust does not require a native runtime to be installed
  • Since it has a strong type checking, it provides a greater speed over Python

Helping Us

Pbss is built by your help. Please check the CONTRIBUTING for more help

Licensing and Price

Pbss is completely free for personal, educational and commercial use and is Licensed under the open-source MIT License. It is completely open-source and will always be free for use. Users are free to share, change and use Pbss in anyway they like

About

Practically Better StyleSheets

Resources

License

Stars

Watchers

Forks

Packages

No packages published