Skip to content

Commit fc78581

Browse files
committed
update readme
1 parent 593d425 commit fc78581

File tree

2 files changed

+81
-4
lines changed

2 files changed

+81
-4
lines changed

LICENSE.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
The MIT License (MIT)
2+
3+
Copyright (c) Mohamed Said <themsaid@gmail.com>
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in
13+
all copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21+
THE SOFTWARE.

readme.md

Lines changed: 60 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,16 @@
11
# Ibis Book Maker
22

3-
First run this command inside your project root:
3+
## Installation
4+
5+
Make sure you have PHP7.3 or above installed on your system.
6+
7+
First, install the composer package globally:
8+
9+
```
10+
composer global require themsaid/ibis
11+
```
12+
13+
Then, run this command inside an empty directory:
414

515
```
616
ibis init
@@ -9,16 +19,62 @@ ibis init
919
This will create the following files and directories:
1020

1121
- /assets
22+
- /assets/fonts
1223
- /assets/cover.jpg
24+
- /assets/theme-light.html
25+
- /assets/theme-dark.html
1326
- /content
1427
- /ibis.php
1528

16-
You may configure your book by editing the ibis.php configuration file.
29+
You may configure your book by editing the `/ibis.php` configuration file.
30+
31+
## Writing Your eBook
32+
33+
Inside the content directory, you can write multiple `.md` files. Ibis uses the headings to divide the book into parts and chapters:
34+
35+
```
36+
# Part 1
37+
38+
<h1> tags define the start of a part. A separate PDF page will be generated to print the part title and any content below.
39+
40+
## Chapter 1
41+
42+
<h2> tags define the start of a chapter. A chapter starts on a new page always.
43+
44+
### Starting with Ibis
45+
46+
<h3> tags define different titles inside a chapter.
47+
```
1748

18-
Inside the content directory, you can write multiple `.md` file and then run:
49+
## Generating PDF eBook
1950

2051
```
2152
ibis build
2253
```
2354

24-
Ibis will parse the files in alphabetical order and store the PDF file in `/export`.
55+
Ibis will parse the files in alphabetical order and store the PDF file in `/export`.
56+
57+
The default is to generate the PDF using the light theme, to generate a PDF using the dark theme:
58+
59+
```
60+
ibis build dark
61+
```
62+
63+
## Generating A Sample
64+
65+
```
66+
ibis sample
67+
68+
ibis sample dark
69+
```
70+
71+
This command will use the generated files from the `ibis build` command to generate samples from your PDF eBook. You can configure which pages to include in the sample by updating the `/ibis.php` file.
72+
73+
## Credits
74+
75+
- [Mohamed Said](https://github.com/themsaid)
76+
- [All Contributors](../../contributors)
77+
78+
## License
79+
80+
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

0 commit comments

Comments
 (0)