📝 Readme > Update for v1
@@ -7,7 +7,7 @@
|
|||||||
},
|
},
|
||||||
"main": "bin/index.js",
|
"main": "bin/index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"demo-folder": "cd test/demo-folder && node ../../bin 'Demo folder' --open false --test true --initial-send true",
|
"demo-folder": "cd test/demo-folder && node ../../bin 'Demo folder' --open false --initial-send true",
|
||||||
"site-dev": "node site/build/dev-server.js",
|
"site-dev": "node site/build/dev-server.js",
|
||||||
"site-build": "node site/build/build.js",
|
"site-build": "node site/build/build.js",
|
||||||
"dev": "npm-run-all --parallel demo-folder site-dev"
|
"dev": "npm-run-all --parallel demo-folder site-dev"
|
||||||
|
|||||||
@@ -1,41 +1,49 @@
|
|||||||
# Keppler
|
# Keppler
|
||||||
|
|
||||||
An efficient way to share your code while presenting
|
Real time code sharing for you lectures and presentations.
|
||||||
|
|
||||||
## What is keppler
|
## What is keppler
|
||||||
|
|
||||||
Keppler lets you share your code during a presentation.
|
Keppler lets you share your code during a presentation.
|
||||||
|
|
||||||
Start keppler inside your project folder, share the URL with the viewers and start coding. When you save or change any file, viewers receive them, can browse through the files tree and discover changes you've made.
|
Start keppler inside your project folder, share the URL with your audience and start coding.
|
||||||
|
Any time you save a file, viewers will receive those changes. They can browse through the files, go back in history, copy the code, download the project, preview images, chat with other viewers, ask the presenter to slow down, etc.
|
||||||
|
|
||||||
Keppler is easy to install and works with NodeJS.
|
<img width="700" src="https://github.com/brunosimon/keppler/raw/master/resources/screenshots/screen-project-1.png" alt="Keppler screen">
|
||||||
|
<img width="700" src="https://github.com/brunosimon/keppler/raw/master/resources/screenshots/screen-project-2.png" alt="Keppler screen">
|
||||||
<img width="600" height="374" src="https://github.com/brunosimon/keppler/raw/master/resources/screenshots/screen-project-2.png" alt="Keppler screen">
|
<img width="700" src="https://github.com/brunosimon/keppler/raw/master/resources/screenshots/screen-project-3.png" alt="Keppler screen">
|
||||||
|
|
||||||
## Instructions
|
## Instructions
|
||||||
|
|
||||||
#### Requirements
|
#### 1 - Install Keppler globally
|
||||||
|
|
||||||
* [NodeJS](https://nodejs.org/en/) installed
|
You must have [NodeJS](https://nodejs.org/en/) and [NPM](https://www.npmjs.org) already installed.
|
||||||
* Keppler installed globally
|
In your console, run:
|
||||||
* Viewers connected to the same network
|
<sup>(You may need to add `sudo` at start)</sup>
|
||||||
|
|
||||||
#### Install Keppler globally
|
|
||||||
|
|
||||||
```
|
```
|
||||||
npm install -g keppler
|
npm install -g keppler
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Start Keppler inside the project folder
|
|
||||||
|
#### 2 - Launch Keppler inside your project folder
|
||||||
|
|
||||||
|
In your console, navigate to your project folder.
|
||||||
|
Then launch Keppler with the name of your choice:
|
||||||
|
|
||||||
```
|
```
|
||||||
cd ./my-awesome-project
|
cd ./my-awesome-project
|
||||||
keppler "My awesome project"
|
keppler "My awesome project"
|
||||||
```
|
```
|
||||||
|
|
||||||
Share the URL that should appear with the viewers.
|
Keppler should open in your default browser and start watching any changes you make on the folder.
|
||||||
|
|
||||||
#### config
|
#### 3 - Share the URL with your audience
|
||||||
|
|
||||||
|
You must be on the same network.
|
||||||
|
Simply share the URL that should appear with your audience and they will start receiving your changes.
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
You can add configuration argument when calling Keppler.
|
You can add configuration argument when calling Keppler.
|
||||||
|
|
||||||
@@ -53,40 +61,43 @@ Arguments list
|
|||||||
|
|
||||||
|name|shortcut|default value|description|
|
|name|shortcut|default value|description|
|
||||||
|---|---|---|---|
|
|---|---|---|---|
|
||||||
|<span style="white-space:nowrap">`--debug`</span>|`-d`|*(number)*`1`|Debug level (`0`: almost no log, `1`: some logs, `2`: many logs)|
|
|<span style="white-space:nowrap">`--debug`</span>|`-d`|*(number)*`1`|Debug level<br>`0`: almost no log<br>`1`: primary logs<br>`2`: too much logs|
|
||||||
|<span style="white-space:nowrap">`--name`</span>|`-n`|*(string)*`No name`|Project name (you can simply add a string after `keppler` keyword like `keppler "My project"`)|
|
|<span style="white-space:nowrap">`--name`</span>|`-n`|*(string)*`No name`|Project name<br>(you can simply add a string after `keppler` keyword like `keppler "My project"`)|
|
||||||
|<span style="white-space:nowrap">`--port`</span>|`-p`|*(number)*`1571`|Server port|
|
|<span style="white-space:nowrap">`--port`</span>|`-p`|*(number)*`1571`|Server port|
|
||||||
|<span style="white-space:nowrap">`--exclude`</span>|`-e`|*(string)*`**/.DS_Store,node_modules/**,vendor/**,.git`|Files to exclude|
|
|<span style="white-space:nowrap">`--exclude`</span>|`-e`|*(string)*`**/.DS_Store,node_modules/**,vendor/**,.git`|Files to exclude|
|
||||||
|<span style="white-space:nowrap">`--open`</span>|`-o`|*(bool)*`true`|Open in default browser|
|
|<span style="white-space:nowrap">`--open`</span>|`-o`|*(bool)*`true`|Open in default browser|
|
||||||
|<span style="white-space:nowrap">`--test`</span>|`-t`|*(bool)*`false`|Start a test project|
|
|<span style="white-space:nowrap">`--test`</span>|`-t`|*(bool)*`false`|Start a test project with testing contents|
|
||||||
|<span style="white-space:nowrap">`--initial-send`</span>|`-i`|*(bool)*`false`|Send files in folder at start|
|
|<span style="white-space:nowrap">`--initial-send`</span>|`-i`|*(bool)*`false`|Send current files in the folder at start|
|
||||||
|<span style="white-space:nowrap">`--max-file-size`</span>|`-m`|*(number)*`99999`|Maximum file size in octets|
|
|<span style="white-space:nowrap">`--max-file-size`</span>|`-m`|*(number)*`99999`|Maximum file size in octets|
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
- Work in any modern browser
|
- Work in any modern browser
|
||||||
- Files tree
|
- File tree
|
||||||
|
- Fuzzy search
|
||||||
- File history/versions
|
- File history/versions
|
||||||
- File versions differences
|
- File versions differences
|
||||||
- Easy copy
|
- Easy copy to clipboard
|
||||||
- Accessible by anyone on the same network
|
- Accessible by anyone on the same network
|
||||||
- App like design
|
- App like design
|
||||||
- Syntax coloring
|
- Syntax coloring
|
||||||
- Multiple projects in one Keppler instance
|
- Multiple projects in one Keppler instance
|
||||||
|
- Chat with other viewers and associate specific files and lines with your messages
|
||||||
## Futur features
|
- Open in default browser
|
||||||
|
|
||||||
- Chat with possibility to associate messages with lines and files
|
|
||||||
- Log project URL and open in default browser
|
|
||||||
- Download file button
|
- Download file button
|
||||||
- Download project button
|
- Download project button
|
||||||
- Keyboard navigation
|
- Alert button
|
||||||
- In app notifications
|
|
||||||
- Browser notifications
|
|
||||||
- Toggle folder
|
|
||||||
- Retractable sidebar
|
|
||||||
- File searching/filtering
|
|
||||||
- Tooltips
|
- Tooltips
|
||||||
- Tablet compatible
|
|
||||||
- Vue.js
|
## Credits
|
||||||
- Font-size control
|
|
||||||
|
##### Development
|
||||||
|
|
||||||
|
- Bruno Simon ([GitHub](https://github.com/brunosimon), [Twitter](https://twitter.com/bruno_simon/), [Site](https://bruno-simon.com))
|
||||||
|
|
||||||
|
##### UX / UI
|
||||||
|
|
||||||
|
- Tom Bonnike
|
||||||
|
- Thibaud Vaubourg
|
||||||
|
- Aymeric Sans
|
||||||
|
- Axel Chalon
|
||||||
|
Before Width: | Height: | Size: 69 KiB After Width: | Height: | Size: 51 KiB |
|
Before Width: | Height: | Size: 138 KiB After Width: | Height: | Size: 75 KiB |
|
After Width: | Height: | Size: 82 KiB |
|
Before Width: | Height: | Size: 6.0 KiB After Width: | Height: | Size: 6.0 KiB |
|
Before Width: | Height: | Size: 327 B After Width: | Height: | Size: 327 B |
|
Before Width: | Height: | Size: 449 B After Width: | Height: | Size: 449 B |
|
Before Width: | Height: | Size: 1.8 KiB After Width: | Height: | Size: 1.8 KiB |
|
Before Width: | Height: | Size: 505 B After Width: | Height: | Size: 505 B |
|
Before Width: | Height: | Size: 786 B After Width: | Height: | Size: 786 B |
|
Before Width: | Height: | Size: 651 B After Width: | Height: | Size: 651 B |
|
Before Width: | Height: | Size: 634 B After Width: | Height: | Size: 634 B |
|
Before Width: | Height: | Size: 785 B After Width: | Height: | Size: 785 B |
|
Before Width: | Height: | Size: 508 B After Width: | Height: | Size: 508 B |
|
Before Width: | Height: | Size: 395 B After Width: | Height: | Size: 395 B |
|
Before Width: | Height: | Size: 6.5 KiB After Width: | Height: | Size: 6.5 KiB |
|
Before Width: | Height: | Size: 886 B After Width: | Height: | Size: 886 B |
|
Before Width: | Height: | Size: 1.6 KiB After Width: | Height: | Size: 1.6 KiB |
|
Before Width: | Height: | Size: 3.2 KiB After Width: | Height: | Size: 3.2 KiB |
|
Before Width: | Height: | Size: 887 B After Width: | Height: | Size: 887 B |
|
Before Width: | Height: | Size: 1.5 KiB After Width: | Height: | Size: 1.5 KiB |
|
Before Width: | Height: | Size: 1.9 KiB After Width: | Height: | Size: 1.9 KiB |
|
Before Width: | Height: | Size: 567 B After Width: | Height: | Size: 567 B |
|
Before Width: | Height: | Size: 3.1 KiB After Width: | Height: | Size: 3.1 KiB |
|
Before Width: | Height: | Size: 1.2 KiB After Width: | Height: | Size: 1.2 KiB |
|
Before Width: | Height: | Size: 1.8 KiB After Width: | Height: | Size: 1.8 KiB |
|
Before Width: | Height: | Size: 1.3 KiB After Width: | Height: | Size: 1.3 KiB |
|
Before Width: | Height: | Size: 456 B After Width: | Height: | Size: 456 B |
|
Before Width: | Height: | Size: 713 B After Width: | Height: | Size: 713 B |
|
Before Width: | Height: | Size: 314 B After Width: | Height: | Size: 314 B |
|
Before Width: | Height: | Size: 449 B After Width: | Height: | Size: 449 B |
|
Before Width: | Height: | Size: 577 B After Width: | Height: | Size: 577 B |
|
Before Width: | Height: | Size: 710 B After Width: | Height: | Size: 710 B |
@@ -2,14 +2,20 @@
|
|||||||
<html lang="en">
|
<html lang="en">
|
||||||
<head>
|
<head>
|
||||||
<meta charset="UTF-8">
|
<meta charset="UTF-8">
|
||||||
<title>Document</title>
|
<title>Mon super site</title>
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
<section>
|
<section>
|
||||||
Bonjour
|
|
||||||
|
<h1>Bonjour</h1>
|
||||||
<form action="#">
|
<form action="#">
|
||||||
<input type="text">
|
<input type="text">
|
||||||
</form>
|
</form>
|
||||||
|
|
||||||
|
<footer>
|
||||||
|
<a href="#">Contact</a>
|
||||||
|
</footer>
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</html>
|
||||||
|
|||||||