Documentations version: 1.9.x

Installation

You may need following things to get started. Please download and install dependencies

• To install paper please make sure you have installed node and gulp. Download Node

• You can use any software of your choice to edit HTML files or use Download VS Code

Installing gulp 4 globally

You will need to remove your current gulp global package before installing v4 in order to do an upgrade.

$ npm rm -g gulp
$ npm install -g gulp-cli

This command removes your current global package and installs v4 from the gulp-cli 4.0 branch.

Make sure you don't get any errors from the first command before you type the second. Depending on your set-up, you may need to run them with sudo.

To verify what version you have installed globally, you can run the below command (and should see a similar output)

$ gulp -v
CLI version 1.2.1

Paper Setup

Its time to open Papert HTML app folder to your favourite editor. Its easy to use an editor which have terminal. Like VS Code or PhpStrom

First of all install all node modules by using this command:

$ npm install

After all node modules installation completed run

gulp watch

gulp watch will create a temporary folder with name of tmp

Production Version

After all changes you need to create production version of your product

$ gulp production

Creating Minified Version

If you want a minified version then run

$ gulp production-min

Above command will create a new folder "dist" it will be fully optimized. It will compress and minify all of your html, css and js files. You can copy folder to your ftp or framework to use it.

Easy Deploy

If you are using version 1.5 or later you can use easy deploy option to upload all files to your ftp server with just one commnand.

Please make sure to run gulp watch first and make changes before you do this and you have to add your server details to upload file. Please open ftp.config and add your server details.

$ gulp deploy

Main Navigation Bar

You don't have to create extra HTML for responsive menu paper convert it for your.

<div class="nav-absolute nav-border nav-light">
  <nav>
      <!-- nav block -->
  </nav>
</div>

<div class="nav-absolute nav-sticky"
     data-nav-sticky-classes="black"
     data-nav-sticky-logo='assets/img/basic/logo-white.png'>
    <nav>
        <!-- your code here-->
    </nav>
</div>

<nav class="mainnav navbar navbar-default">
    <div class="container">
        <div id="dl-menu" class="xv-menuwrapper responsive-menu">
            <!-- Add nav links here-->
        </div>
    </div>
</nav>

<ul class="dl-menu">
    <li class="parent megamenu"><a href="#">Home</a>
        <ul class="lg-submenu">
            <li>
                <a>Column 1 Heading</a>
                <ul class="lg-submenu">
                    <li><a href="#">Column 1 Link</a></li>
                    <li><a href="#">Column 1 Link</a></li>
                </ul>
            </li>
            <li>
                <a>Column 2 Heading</a>
                <ul class="lg-submenu">
                    <li><a href="#">Column 2 Link</a></li>
                    <li><a href="#">Column 2 Link</a></li>
                </ul>
            </li>
        </ul>
    </li>
</ul>

Overlays

Adding overlay is pretty easy. Jus copy overlay div inside a relative section. Overlay is flexible you can change colors and direction as you want.

<div class="overlay"
     data-start="#f5abab"
     data-end="#a86d07"
     data-orientation="tobottom"
     data-opacity=".5">
</div>

Smooth Scroll

You can make any URL to work for smooth scroll. It only work inside a page. Useful for single page website. For demo you can check sidebar of this documentation page. Just add a scroll class to make it work.

<a href="#section-id" class="scroll">Go To Section></a>

<div class="scroll">
<a href="#section-id">Go To Section></a>
</div>

Sticky Item

To make an item sticky add sticky class

<div class="sticky">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit. Accusantium ad architecto asperiores dolor ea exercitationem hic ipsam iusto maiores natus nulla numquam perspiciatis quasi quis recusandae, reiciendis rerum similique ut.
</div>

Charts

Paper is using chart.js you may need to check chart.js documents to make modifications.

<canvas class="chart"
    data-type="pie"
    data-labels="HTML,WordPress,Laravel"
    data-values="12, 19, 16"
    width="400"
    height="400">
</canvas>

You can use above markup at charts. Change type if you want.

Contact Form

Please make sure you have change email in contact form for this you need to edit "assets/php/submit.php" add your email

$your_email="your_email@site.com";

You can also add more options if you want or change email template.

Compress Images

To speed your site you may need to compress some of your images. For that run command:

$ gulp img-compress

images in demo folder will be compressed only. you must first create production version. you can change folder name in gulpfile.js if you want.