nunta/README.md

83 lines
4.8 KiB
Markdown
Raw Normal View History

# [Start Bootstrap - Agency](https://startbootstrap.com/theme/agency)
2014-10-31 04:43:03 +01:00
[Agency](https://startbootstrap.com/theme/agency) is a one page, agency portfolio theme built with [Bootstrap](https://getbootstrap.com/) created by [Start Bootstrap](https://startbootstrap.com/). This theme features several content sections, a responsive portfolio grid, modal windows for each portfolio item, and a working PHP based contact form.
2014-10-31 04:43:03 +01:00
2017-08-20 03:54:22 +02:00
## Preview
2017-08-20 07:46:52 +02:00
[![Agency Preview](https://assets.startbootstrap.com/img/screenshots/themes/agency.png)](https://startbootstrap.github.io/startbootstrap-agency/)
2014-10-31 04:43:03 +01:00
2020-06-17 23:49:57 +02:00
**[View Live Preview](https://startbootstrap.github.io/startbootstrap-agency/)**
2017-08-20 03:54:22 +02:00
## Status
2020-06-17 23:49:57 +02:00
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/StartBootstrap/startbootstrap-agency/master/LICENSE)
2017-08-20 03:54:22 +02:00
[![npm version](https://img.shields.io/npm/v/startbootstrap-agency.svg)](https://www.npmjs.com/package/startbootstrap-agency)
## Download and Installation
To begin using this template, choose one of the following options to get started:
2020-04-07 00:19:58 +02:00
- [Download the latest release on Start Bootstrap](https://startbootstrap.com/theme/agency)
2020-04-07 00:19:58 +02:00
- Install using npm: `npm i startbootstrap-agency`
2020-06-17 23:49:57 +02:00
- Clone the repo: `git clone https://github.com/StartBootstrap/startbootstrap-agency.git`
- [Fork, Clone, or Download on GitHub](https://github.com/StartBootstrap/startbootstrap-agency)
2017-08-20 03:54:22 +02:00
## Usage
2016-06-24 23:00:59 +02:00
2017-08-20 03:54:22 +02:00
### Basic Usage
2020-04-07 00:19:58 +02:00
After downloading, simply edit the HTML and CSS files included with `dist` directory. These are the only files you need to worry about, you can ignore everything else! To preview the changes you make to the code, you can open the `index.html` file in your web browser.
2017-08-20 03:54:22 +02:00
### Advanced Usage
2020-04-07 00:19:58 +02:00
Clone the source files of the theme and navigate into the theme's root directory. Run `npm install` and then run `npm start` which will open up a preview of the template in your default browser, watch for changes to core template files, and live reload the browser when changes are saved. You can view the `package.json` file to see which scripts are included.
2020-04-07 00:19:58 +02:00
#### npm Scripts
2017-08-22 02:06:26 +02:00
2020-04-07 00:19:58 +02:00
- `npm run build` builds the project - this builds assets, HTML, JS, and CSS into `dist`
- `npm run build:assets` copies the files in the `src/assets/` directory into `dist`
- `npm run build:pug` compiles the Pug located in the `src/pug/` directory into `dist`
- `npm run build:scripts` brings the `src/js/scripts.js` file into `dist`
- `npm run build:scss` compiles the SCSS files located in the `src/scss/` directory into `dist`
- `npm run clean` deletes the `dist` directory to prepare for rebuilding the project
- `npm run start:debug` runs the project in debug mode
- `npm start` or `npm run start` runs the project, launches a live preview in your default browser, and watches for changes made to files in `src`
2017-08-22 02:06:26 +02:00
2020-04-07 00:19:58 +02:00
You must have npm installed in order to use this build environment.
2014-10-31 04:43:03 +01:00
2021-06-06 01:56:57 +02:00
### Contact Form
The contact form available with this theme is prebuilt to use [SB Forms](https://startbootstrap.com/solution/contact-forms).
SB Forms is a simple form solution for adding functional forms to your theme. Since this theme is prebuilt using our
SB Forms markup, all you need to do is sign up for [SB Forms on Start Bootstrap](https://startbootstrap.com/solution/contact-forms).
After signing up you will need to set the domain name your form will be used on, and you will then see your
access key. Copy this and paste it into the `data-sb-form-api-token='API_TOKEN'` data attribute in place of
`API_TOKEN`. That's it! Your forms will be up and running!
If you aren't using SB Forms, simply delete the custom data attributes from the form, and remove the link above the
closing `</body>` tag to SB Forms.
2018-07-09 22:59:20 +02:00
## Bugs and Issues
Have a bug or an issue with this template? [Open a new issue](https://github.com/StartBootstrap/startbootstrap-agency/issues) here on GitHub or leave a comment on the [theme overview page at Start Bootstrap](https://startbootstrap.com/theme/agency).
2017-08-20 03:54:22 +02:00
## About
2020-04-07 00:19:58 +02:00
Start Bootstrap is an open source library of free Bootstrap themes and templates. All of the free themes and templates on Start Bootstrap are released under the MIT license, which means you can use them for any purpose, even for commercial projects.
2017-08-20 03:54:22 +02:00
2020-04-07 00:19:58 +02:00
- <https://startbootstrap.com>
- <https://twitter.com/SBootstrap>
2014-10-31 04:43:03 +01:00
Start Bootstrap was created by and is maintained by **[David Miller](https://davidmiller.io/)**.
2014-10-31 04:43:03 +01:00
- <https://davidmiller.io>
- <https://twitter.com/davidmillerhere>
2020-04-07 00:19:58 +02:00
- <https://github.com/davidtmiller>
2014-10-31 04:43:03 +01:00
2020-04-07 00:19:58 +02:00
Start Bootstrap is based on the [Bootstrap](https://getbootstrap.com/) framework created by [Mark Otto](https://twitter.com/mdo) and [Jacob Thorton](https://twitter.com/fat).
2014-10-31 04:43:03 +01:00
## Copyright and License
Copyright 2013-2023 Start Bootstrap LLC. Code released under the [MIT](https://github.com/StartBootstrap/startbootstrap-agency/blob/master/LICENSE) license.