2017 © Pedro Peláez
 

library startless

Startless - Less starting bloc for any projects

image

deefaze/startless

Startless - Less starting bloc for any projects

  • Tuesday, April 3, 2018
  • by deefaze
  • Repository
  • 1 Watchers
  • 0 Stars
  • 10 Installations
  • Shell
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 1 Versions
  • 0 % Grown

The README.md

StartLess

Table of content

1. installation, (*1)

1.1 Composer\ 1.2 or Download\ 1.3 View reference page, (*2)

2. Usage @ Dev, (*3)

2.1 Locate main Less file\ 2.2 Configuration\ 2.3 Compress CSS / Sourcemap\ 2.4 LESS Mixins\ 2.5 CSS Rules, (*4)

3. Usage @ Production, (*5)

What is StartLess ?

Startless is a Less/Css starting bloc for any Html/CSS web application. Startless include base of css reset, normalization, fonts and colors theme., (*6)

What StartLess use ?

Startless use LESS/CSS type files., (*7)

Fonts theme base on some of Google Fonts like Roboto, Lato, Ubuntu, Oswald..., (*8)

1. Installation

1.1 Composer

Run this composer command in your terminal :, (*9)

composer require deefaze/startless dev-master

1.2 or Download

Go to Deefaze/starless repo, select master branch and click Clone or download > Download ZIP or just Click here., (*10)

1.3 View reference page

The test/index.html cannot be called directly from file:/// protocol, launch from your own server., (*11)

Starless provide a script for create a PHP Server on 127.0.0.254:80., (*12)

Go to Startless root path, open a terminal (CMD on Windows) and run win-php-server.cmd (NB: require a valid PHP > v5.3 installation), this launch automaticaly the index in your browser. If not, go to http://127.0.0.254:80/test/index.html, (*13)

Other terminal in your editor ? You can launch CMD into your current terminal (terminalception), run like this :, (*14)

dev@dev-PC MINGW64 /s/www/startless/ (master)
$ cmd /k

next, run win-php-server.cmd from CMD :, (*15)

Microsoft Windows [version 10]
(c) 2017 Microsoft Corporation. All rights reserved.

S:\www\startless\win-php-server.cmd

Return to your terminal ? run exit from CMD., (*16)

↥ Return to TOC, (*17)

2. Usage @ Dev

2.1 Locate main LESS file

The main file is src/scss/main.less. But this, contain only @import directives. src/scss/Public/ folder is more interesting., (*18)

2.2 Configuration

config\ contain Startless config.less, you need to edit this :, (*19)

// Theme [default, belle, onedark]
@theme-selector : 'onedark';

// Font [default, raleway, ubuntu, roboto, laosov (lato, oswald, overpass), ibm]
@font-selector  : 'ibm';

2.3 Compress CSS / Sourcemap

This is localized into scss/main.less file.\ If you use a less compiler who support first line parameter like :, (*20)

// out: ../css/styles.css, compress: false, sourcemap: false

You just need to set compress or sourcemap to true/false., (*21)

2.4 LESS Mixins

components/ contain Less mixins, themes, fonts, no CSS rules here ..., (*22)

components/themes/ contain all colors themes, you can add yours here.\ components/themes.less Startless themes core file., (*23)

components/fonts/ contain all fonts configurations, you can add yours here.\ components/fonts.less Startless fonts core file., (*24)

2.5 CSS Rules

public\ contain all CSS rules. Put yours here. This already contain a basic reset and normalizer, root (:root{}) variables, document parameters ..., (*25)

↥ Return to TOC, (*26)

3. Usage @ Production

Compile scss/main.less and use css/styles.css in your project, like :, (*27)

<head>
  { ... }
  <link type="text/css" rel="stylesheet" href="vendor/deefaze/startless/src/css/styles.css">
  { ... }
</head>

NB : On standard production, startless is not needed, you can deploy CSS in any ways : 1. copy css/styles.css file in your assets... 2. set the out parameter in main.less for targeting your assets... 3. use lessc in terminal (require npm + less installation) and compile to your assets..., (*28)

&mapstoup; Return to TOC, (*29)

The Versions

03/04 2018

dev-master

9999999-dev

Startless - Less starting bloc for any projects

  Sources   Download