- C 97.4%
- Makefile 0.8%
- CSS 0.6%
- Objective-C 0.6%
- Shell 0.5%
- Other 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
Some checks failed
Tag version / run_script (push) Has been cancelled
Increments-patch-version-of: misc |
||
| .github | ||
| build | ||
| external | ||
| scripts | ||
| src | ||
| .gitignore | ||
| .gitmodules | ||
| LICENSE.LGPL | ||
| README.md | ||
Netzhaut
Netzhaut is a multi-purpose open-source Web-Browser-Engine written from scratch in modern C. A web-browser-engine is software which runs web-content on client machines. Popular examples are Chromium (Chrome, Google), Gecko (Firefox, Google) and WebKit (Safari, Apple).
Contents
Build
0. Check OS support
- Linux ✅
- MacOs ❌
- Windows ❌
1. Get source-code
using Git
git clone https://github.com/dajofrey/Netzhaut
cd Netzhaut && git submodule update --init --recursive
2 Prepare build
MacOS dependencies:
brew install freetype harfbuzz openssl
3. Compile source-code into libraries and binaries
using Make
# Full compile
make -f build/automation/lib.mk all
make -f build/automation/bin.mk all
# Selective compile
make -f build/automation/lib.mk lib-nh-api lib-nh-*
make -f build/automation/bin.mk bin-nh-wsi bin-nh-*
Binaries
nh-css
./nh-css <file-path> [Tokens | Rules | Objects]
Parses a file containing CSS rules and dumps the parsing result.
file-path File-path to CSS file.
Tokens If specified, prints CSS tokens.
Rules If specified, prints CSS rules.
Objects If specified, prints CSS objects.
nh-html
./nh-html <file-path> [config-options]
Displays an HTML file.
file-path File-path to HTML file.
config-options If specified, passes custom config-options to Netzhaut.
nh-ecmascript
./nh-ecmascript <file-path> [config-options]
Runs a ECMAScript script.
file-path File-path to ECMAScript file.
config-options If specified, passes custom config-options to Netzhaut.
nh-webidl
./nh-webidl <file-path> [config-options]
Runs a ECMAScript script with WebIDL interfaces.
file-path File-path to ECMAScript file.
config-options If specified, passes custom config-options to Netzhaut.
nh-monitor
./nh-monitor <port>
Launches a CLI interface for monitoring.
port Monitors another Netzhaut process over localhost TCP via port.
nh-wsi
./nh-wsi
Launches empty window for testing purposes.
Design
nh-ecmascript
Host/ECMAScript sends jobs to Runtime workload (1 runtime workload)
Runtime enques jobs in Agent
Agent Cluster (x cluster workloads) executes jobs from Agent
Add a new intrinsic method
- add it to .is
- run generator
- implement function
- compile
FAQ
How-to use nh-monitor
- Run nh-monitor on port 50123 or any other open port.
./bin/nh-monitor 50123
- Run nh-html with client-port specified and in block mode.
./bin/nh-html test.html "nh-monitor.client_port:50123;nh-monitor.block:1;nh-core.debug.monitor_on:1;"