Skip to content

Commit

Permalink
Updated docs
Browse files Browse the repository at this point in the history
  • Loading branch information
IonicaBizau committed Mar 25, 2024
1 parent 201cd15 commit 71a3467
Show file tree
Hide file tree
Showing 6 changed files with 145 additions and 65 deletions.
4 changes: 4 additions & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
github: ionicabizau
patreon: ionicabizau
open_collective: ionicabizau
custom: https://www.buymeacoffee.com/h96wwchmy
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,7 @@
*~
*.log
node_modules
*.env
.DS_Store
package-lock.json
.bloggify/*
75 changes: 25 additions & 50 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,66 +1,41 @@
# :eight_spoked_asterisk: :stars: :sparkles: :dizzy: :star2: :star2: :sparkles: :dizzy: :star2: :star2: Contributing :star: :star2: :dizzy: :sparkles: :star: :star2: :dizzy: :sparkles: :stars: :eight_spoked_asterisk:
# Contributing :star: :star2: :dizzy:

So, you want to contribute to this project! That's awesome. However, before
doing so, please read the following simple steps explaining how to contribute. This will
make life easier and help avoid wasting time on things that are not
requested. :sparkles:
So, you want to contribute to this project? That's awesome! However, before doing so, please read the following simple steps on how to contribute. This will make life easier and avoid wasting time on things that are not requested. ✨

## Discuss the changes before doing them
- First of all, open an issue in the repository, using the [bug tracker][1],
describing the contribution you would like to make, the bug you found or any
other ideas you have. This will help us to get you started on the right
foot.
## Discuss the changes before making them
To begin, open an issue in the repository using the [bug tracker][1]. Describe the contribution you'd like to make, the bug you've found, or any other ideas you have. This step will help us get you started on the right track.

- If it makes sense, add the platform and software information (e.g. operating
system, Node.JS version etc.), screenshots (so we can see what you are
seeing).
If it is relevant, include platform and software information (e.g., operating system, Node.JS version, etc.) and screenshots to help us understand what you're experiencing.

- It is recommended to wait for feedback before continuing the next steps.
However, if the issue is clear (e.g. a typo) and the fix is simple, you can
continue to fix it.
We recommend waiting for feedback before proceeding to the next steps. However, if the issue is clear, such as a typo, and the fix is simple, you can go ahead and fix it.

## Fixing issues
- Fork the project in your account and create a branch with your fix:
`some-great-feature` or `some-issue-fix`.
## Fixing Issues
Begin by forking the project to your own account, and create a branch for your fix, naming it either `some-great-feature` or `some-issue-fix`.

- Commit your changes in that branch, writing the code following the
[code style][2]. If the project contains tests (generally, the `test`
directory), you are encouraged to add a test as well. :memo:
Commit your changes to that branch, adhering to the [code style][2]. If the project includes tests (usually located in the `test` directory), we encourage you to add a test as well. :memo:

- If the project contains a `package.json` or a `bower.json` file add yourself
in the `contributors` array (or `authors` in the case of `bower.json`;
if the array does not exist, create it):
If the project includes a `package.json` or a `bower.json` file, add yourself to the `contributors` array (or `authors` in the case of `bower.json`). If the array doesn't exist, create it as shown below:

```json
{
"contributors": [
"Your Name <and@email.address> (http://your.website)"
]
}
```
```json
{
"contributors": [
"Your Name <your@email.address> (http://your.website)"
]
}
```

## Creating a pull request
## Creating a Pull Request
Start by opening a pull request and make sure to reference the initial issue in the pull request message (e.g., *fixes #<your-issue-number>*). Provide a clear and descriptive title to help everyone understand what is being fixed or improved.

- Open a pull request, and reference the initial issue in the pull request
message (e.g. *fixes #<your-issue-number>*). Write a good description and
title, so everybody will know what is fixed/improved.
If applicable, consider adding screenshots, gifs, or any other visual aids that can make it easier to understand the changes you've made.

- If it makes sense, add screenshots, gifs etc., so it is easier to see what
is going on.
## Wait for Feedback
Before accepting your contributions, we will review them. You may receive feedback regarding what needs to be addressed in your modified code. If so, simply continue making commits to your branch, and the pull request will be automatically updated.

## Wait for feedback
Before accepting your contributions, we will review them. You may get feedback
about what should be fixed in your modified code. If so, just keep committing
in your branch and the pull request will be updated automatically.

## Everyone is happy!
Finally, your contributions will be merged, and everyone will be happy! :smile:
Contributions are more than welcome!
## Everyone Is Happy!
Ultimately, your contributions will be merged, and everyone will be delighted! 😄 Contributions are more than welcome!

Thanks! :sweat_smile:



[1]: https://github.com/Bloggify/rucksack/issues

[1]: /issues
[2]: https://github.com/IonicaBizau/code-style
5 changes: 5 additions & 0 deletions DOCUMENTATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Ruckasck
Creates a new instance of `Ruckasck`.

#### Params

- **Object** `opts`: The Rucksack options.

#### Return
Expand All @@ -17,26 +18,30 @@ Creates a new instance of `Ruckasck`.
Watch the CSS paths.

#### Params

- **String** `resPath`: The CSS resource path.

### `addCSS(resPath, inline)`
Adds a new CSS path.

#### Params

- **String** `resPath`: The CSS resource path to add.
- **Boolean** `inline`: Whether to add the CSS content inline or not.

### `bundleJS(output, cb)`
Bundles the JS files.

#### Params

- **String** `output`: The output of the JS script.
- **Function** `cb`: The callback function.

### `bundleCSS(output, cb)`
Bundles the CSS files.

#### Params

- **String** `output`: The output of the CSS script.
- **Function** `cb`: The callback function.

Expand Down
118 changes: 105 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
<!-- Please do not edit this file. Edit the `blah` field in the `package.json` instead. If in doubt, open an issue. -->



Expand All @@ -6,28 +7,54 @@



[![rucksack](http://i.imgur.com/hSPcrjC.png)](#)







![rucksack](http://i.imgur.com/hSPcrjC.png)




# rucksack

JavaScript and CSS bundler.
[![Version](https://img.shields.io/npm/v/rucksack.svg)](https://www.npmjs.com/package/rucksack) [![Downloads](https://img.shields.io/npm/dt/rucksack.svg)](https://www.npmjs.com/package/rucksack)







> JavaScript and CSS bundler.
















## Installation
## :cloud: Installation

```sh
$ npm i rucksack
# Using npm
npm install --save rucksack

# Using yarn
yarn add rucksack
```


Expand All @@ -38,17 +65,16 @@ $ npm i rucksack



## Example




## :clipboard: Example


```js
"use strict"

const Rucksack = require("..")
```js
const Rucksack = require("rucksack")

// Create a new bundler
let bundler = new Rucksack({
Expand Down Expand Up @@ -77,26 +103,44 @@ bundler.bundleCSS(`${__dirname}/test.css`)
bundler.bundleJS(`${__dirname}/test.js`)
// => info [Tuesday, November 28, 2017 06:53:48 AM] Bundling the scripts.
// => (function e(t,n,r){...})

```






## Documentation






## :question: Get Help

There are few ways to get help:



1. Please [post questions on Stack Overflow](https://stackoverflow.com/questions/ask). You can open issues with questions, as long you add a link to your Stack Overflow question.
2. For bug reports and feature requests, open issues. :bug:







## :memo: Documentation


### constructor

Ruckasck
Creates a new instance of `Ruckasck`.

#### Params

- **Object** `opts`: The Rucksack options.

#### Return
Expand All @@ -106,26 +150,30 @@ Creates a new instance of `Ruckasck`.
Watch the CSS paths.

#### Params

- **String** `resPath`: The CSS resource path.

### `addCSS(resPath, inline)`
Adds a new CSS path.

#### Params

- **String** `resPath`: The CSS resource path to add.
- **Boolean** `inline`: Whether to add the CSS content inline or not.

### `bundleJS(output, cb)`
Bundles the JS files.

#### Params

- **String** `output`: The output of the JS script.
- **Function** `cb`: The callback function.

### `bundleCSS(output, cb)`
Bundles the CSS files.

#### Params

- **String** `output`: The output of the CSS script.
- **Function** `cb`: The callback function.

Expand All @@ -137,15 +185,59 @@ Bundles the CSS files.



## How to contribute








## :yum: How to contribute
Have an idea? Found a bug? See [how to contribute][contributing].



## License
See the [LICENSE][license] file.













## :dizzy: Where is this library used?
If you are using this library in one of your projects, add it in this list. :sparkles:

- `bloggify`
- `bloggify-cli`
- `bloggify-prebuilt`











## :scroll: License

[MIT][license] © [Bloggify][website]






[license]: /LICENSE
[website]: https://bloggify.org
[contributing]: /CONTRIBUTING.md
[docs]: /DOCUMENTATION.md
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

0 comments on commit 71a3467

Please sign in to comment.