powerpage

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #llm #golang #go #deep-learning #nodejs #awesome #pytorch #security #mcp #openai

(★ 18)

A lightweight web browser for desktop application development by JavaScript/html/css (like electron).

powerpage Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Introduction

[**PowerPage**](https://github.com/casualwriter/powerpage) is a lightweight web browser with DB capability 
and windows accessibility, for rapid development of HTML/Javascript application.

Powerpage will connect to database, load startup page using Microsoft web-browser control (**equivalent to IE11**), 
and communicate with html/js page by ``pb:// or ps://`` protocol to provide below features

* (Run) Call External Program 
* (File) Access file system 
* (DB) Database Accessibility
* (PB) Call Powerbuilder Windows/Functions 
* (Misc) Global variables, sessions information

### Motivation

For security reason, all browsers are working hard to prevent unauthorized access of OS resources (ie. printer, files, database etc..).
In other side, developers working hard to access OS resources for application development. Development within web-browser just like 
a game of police-theft. 
 
I had longed for a web browser which has DB connectivity and OS accessibility, 
so that can coding HTML/JavaScript application like Electron.

Somehow, quite frustrated in many "installation" works, to setup development environment and deploy application. 
It always goes wrong by unknown reasons and stuck into unknown situations. 
What I want is "copy-and-run" and "code-and-play" (i.e. no installation, no compile, no deployment).

I try to make "Powerpage" solution for this purpose.

### Features

Powerpage is a ready-make Electron-like solution. No install, no compile, no packing. 
Just open editor to start coding.

* Portable solution. No installation
* Single execute file. No deployment.
* No dependence, pure html/javascript/css
* Code-and-Play instantly 
* Make use of javascript library (which support IE11)
* Command Line for multiple purpose (e.g. save url page, generate PDF)
* Work with Powerbuilder (e.g. call powerbuilder window/function/datawindow)

ps: due to the limitation of Microsoft web-browser control, Powerpage web browser is **equivalent to IE11 (not chrome)**!

### Run Powerpage

Powerpage is a single executable program. just download and run ``powerpage.exe``.

* Simply download from [release](https://github.com/casualwriter/powerpage/tree/main/release) folder, unzip the file, and run ``powerpage.exe``
* Source code and latest version can be downloaded from "source" folder.

### Files & Applications

* ``powerpage.exe`` is the executable file of powerpage. (single executable file)
* ``powerpage.html`` is the startup html file (i.e. javascript/html application)
* ``powerpage.ini`` is the config file for DB connection and misc setup
* ``powerpage.js`` is the initial javascript lib for interface
* ``*.dll`` is Powerbuilder run-time files

**Source code**

Powerpage is developed by Powerbuilder 10.5, source code is powerpage.pbl (only one file)

* `powerpage.pbl` is powerbuilder source code 
* `powerpage.pbt` is powerbuilder target file
* exported source entries can be found under folder [src\*](https://github.com/casualwriter/powerpage/tree/main/source/src)
* to compile the program, add `powerpage.pbt` to workspace, and compile by `p_powerpage`

**Applications**

* ``pp-md-editor.html`` is pp-application of "Powerpage Markdown Editor"
* ``pp-web-crawler.html`` is pp-application of "Powerpage Web Crawler"

### How PowerPage work?

Powerpage open a window with MS WebBrowser Control. When HTML page is loaded, Powerpage will import ``powerpage.js`` 
to initialize ``pb`` javascript object to provide Powerpage interface.

HTML page may via the following channel to talk to main program

1. recommended call by javascript: ``pb.apiFunction()``, e.g. pb.run('notepad.exe')
2. by url: ``&lt;a href="pb://command/parameters">Text&lt;/a>`` or ``window.location = "pb://command/parameters"``
3. by change title: ``document.title = "pb://command/parameters"``

Powerpage will interpret and execute the command, and pass the result to HTML page by calling js function ``pb.router(callback, result, type, cmd)``

for example:

* Run notepad.exe to edit powerpage.ini -> ``javascript:pb.run('notepad.exe powerpage.ini')`` or ``pb://run/notepad.exe powerpage.ini``
* Run SQL1 and callback showData() -> ``javascript:pb.callback('showData').db.query(sql1)`` or ``pb://callback/showData/db/query/@sql1``  
* Run update SQL2 -> ``javascript:pb.db.execute(sql3)`` or ``pb://db/execute/@sql3``
* Call About window -> ``javascript:pb.window('w_about')`` or ``pb://window/w_about``

### Documentation

please refer to latest documents in github-page: <https://casualwriter.github.io/powerpage>
 
* [Home](https://casualwriter.github.io/powerpage)
* [API Reference](https://casualwriter.github.io/powerpage/index.html?file=interface.md)
* [Development Guide](https://casualwriter.github.io/powerpage/index.html?file=development.md)

## Command Line

Beside running html/javascript applications, Powerpage has wide usage by using command-line parameters.

~~~
powerpage.exe /ini={ini-file} /url={start-url}  /script={script-file} /fullscreen /print /silent
              /save={save-html} /pdf={output-pdf-file} /select={selector} /delay={1000}
~~~

* `/ini={ini-file}` specifies ini setting file. Aplication could be changed by change the ini file.
* `/url={start-url}` is used to specify startup link. Aplication could be changed by change startup link.
* `/script={script-file}` will specify user-defined javascript instead of `powerpage.js`. useful for js injection. 
* `/fullscreen` or `/kiosk` will run in fullscreen mode, useful for kiosk, or display board.
* `/silent` will run in silent mode (i.e. suppress js error message)
* `/print`` will load startup url, print and close program.
* `/save={save-html}` will load startup url, save to html file, and close program.  Useful for web-crawler
* `/pdf={output-pdf-file}` will load startup url, generate PDF file, and close program. useful for PDF generation.
* `/delay={1000}` specifies delay time (by milliseconds) for print/save/pdf options
* `/select={css-selector}` is applied for **print/save** to select part of html elements.  Useful for web-crawler

### Samples of using command-line

**General Usage**
* ``powerpage.exe /ini=pp-md-editor.ini`` run "Powerpage Markdown Editor" with its config ini
* ``powerpage.exe /url=pp-md-editor.html`` run "Powerpage Markdown Editor"
* ``powerpage.exe /url=pp-web-crawler.html`` run "Powerpage Web Crawler"
* ``powerpage.exe /url=pp-kanban.html /fullscreen`` run Kanban display board in fullscreen mode
* ``powerpage.exe /url=pp-md-document.html`` open "Powerpage Documents"
* ``powerpage.exe /url=facebook.com`` /script=myfacebook.js`` inject js script for facebook.com

**print page or save to html/pdf**
* ``powerpage.exe /url=http://haodoo.net/ /print`` print page of haodoo.net
* ``powerpage.exe /url=http://haodoo.net/ /pdf=haodoo.pdf`` save the page of haodoo.net to PDF file
* ``powerpage.exe /url=http://haodoo.net/ /save=haodoo.html`` save page "haodoo.net" to haodoo.html

**save web content to file (whole page or select by css-selecotr)**
* ``powerpage.exe /url=https://pingshan-tech.com/powerpage/doc /save=README.html`` save powerpage README (whole page)
* ``powerpage.exe /url=https://pingshan-tech.com/powerpage/doc /save=README.html /select=#content`` save powerpage README (#content:outerHTML)
* ``powerpage.exe /url=https://pingshan-tech.com/powerpage/doc /save=README.html /select=@#content`` save powerpage README (#content:innerText)
* ``powerpage.exe /url=https://pingshan-tech.com/powerpage/doc /save=README.html /select=#right-panel`` save powerpage README (#right-panel)

**save github content to html/pdf (select==.markdown-body)**
* ``powerpage /url=https://github.com/casualwriter/powerpage /save=README.html /select=.markdown-body`` to save README from github (has error msg)
* ``powerpage /url=https://github.com/casualwriter/powerpage /save=README.html /select=.markdown-body /silent`` to save README from github (silent mode)
* ``powerpage /url=https://github.com/casualwriter/powerpage /pdf=README.pdf /select=.markdown-body /silent`` to save in PDF format

## Application Samples

Powerpage is released with some sample applications.

* [Powerpage](https://github.com/casualwriter/powerpage) as Quick Reference, or self-demonstration
* [Powerpage - Markdown Editor](https://github.com/casualwriter/powerpage-md-editor) 
* [Powerpage - Web Crawler](https://github.com/casualwriter/powerpage-web-crawler) 
* Powerpage - [Document By Markdown](https://github.com/casualwriter/powerpage-md-document) 
 
  
## Modification History

* 2021/05/07, v0.41, initial version of Powerpage 
* 2021/05/14, v0.43, code simple markdown editor [powerpage-md-editor](https://github.com/casualwriter/powerpage-md-editor)
* 2021/06/03, v0.48, generate PDF report (using wkhtmltopdf.exe)
* 2021/06/16, v0.50, more command line options
* 2021/07/02, v0.54, crawl web function, code [powerpage-web-crawler](https://github.com/casualwriter/powerpage-web-crawler)
* 2021/07/08, v0.55, refine powerpage, update [powerpage-web-crawler](https://github.com/casualwriter/powerpage-web-crawler)
* 2021/10/05, v0.57, code document framework, and markdown parser
* 2021/10/14, v0.60, align all version (powerpage-md-editor,powerpage-web-crawler) to v0.60
* 2021/10/20, v0.62, refine markdown parser; update pb source to \src\*.*
* 2021/11/02, v0.63, remove local documents, host in [github-page](https://casualwriter.github.io/powerpage) now.

powerpage

powerpage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

powerpage

powerpage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README