Skip to content

Commit

Permalink
Improve README, update LICENSE, add a CONTRIBUTING
Browse files Browse the repository at this point in the history
This commit adds some more information to the README file,
updates the Copyright year in the LICENSE
and adds a CONTRIBUTING file, to give some hints, how to contribute.
  • Loading branch information
akreuzkamp committed Mar 2, 2015
1 parent 44bea45 commit c42386b
Show file tree
Hide file tree
Showing 3 changed files with 71 additions and 3 deletions.
14 changes: 14 additions & 0 deletions CONTRIBUTING
@@ -0,0 +1,14 @@
QmlWeb is a KDE project.

That means you can contribute like you do to any KDE project:

- Report bugs on https://bugs.kde.org/enter_bug.cgi?product=QmlWeb
- Send patches to https://reviewboard.kde.org/r/new/

If you have made a few commits and wish to contribute more actively,
please apply for a KDE contributor account:
https://techbase.kde.org/Contribute/Get_a_Contributor_Account.


Alternatively, if you insist on it, you may fill a pull-request on
GitHub (https://github.com/akreuzkamp/qmlweb).
4 changes: 2 additions & 2 deletions LICENSE
@@ -1,11 +1,11 @@
QMLWEB project is released under the "new" BSD license. As there was no
QmlWeb project is released under the "new" BSD license. As there was no
organization behind the project, I stripped out related parts of license text.
It's a lawyer talk, I hope I got it right.

---

Copyright (c) 2012, Lauri Paimen
Copyright (c) 2013, Anton Kreuzkamp
Copyright (c) 2015, Anton Kreuzkamp
All rights reserved.

Redistribution and use in source and binary forms, with or without
Expand Down
56 changes: 55 additions & 1 deletion README
@@ -1 +1,55 @@
Prototype of QML engine in a web browser.
== A QML engine in a web browser ==

The QML language is well-suited for building web applications. Goal is
to develop the required technologies for that. This is a runtime
environment in JavaScript and the required QML modules to render in
web browsers. Other applications can be considered. Main focus is on
developing hybrid-applications using native (Qt) and web technologies
of any scale, not forgetting the creation of sole web applications.
QmlWeb is not intended to run native QtQuick applications using QmlWeb
without migration effort.

=== Get started ===

To use QmlWeb, you need a simple html file to load and start QmlWeb.
This simple file will do:

`
<!DOCTYPE html>
<html>
<head>
<title>QmlWeb Demo</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/javascript" src="../qmlweb/src/parser.js"></script>
<script type="text/javascript" src="../qmlweb/src/import.js"></script>
<script type="text/javascript" src="../qmlweb/src/qtcore.js"></script>
</head>
<body style="margin: 0;">
<script type="text/javascript">
var qmlEngine = new QMLEngine();
qmlEngine.loadFile("main.qml");
qmlEngine.start();
</script>
</body>
</html>
`

The next thing you need is a QML-file:

`
import QtQuick 1.1

Item {

Text {
anchors.centerIn: parent
text: "Hello World!"
font.pointSize: 12
color: grey
}

}
`

That's it.
_Hint: To get the root Item fill the whole screen, just don't set it's size._

0 comments on commit c42386b

Please sign in to comment.