wt-home.xml 50 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <messages>
  3. <message id="template">
  4. <div id="top_wrapper">
  5. <div id="top_content">
  6. ${languages}
  7. <div id="top_wt">
  8. <a href="//www.emweb.be/">
  9. <img src="/css/wt/emweb_powered.jpg" alt="Emweb" height="22" />
  10. </a>
  11. </div>
  12. </div>
  13. </div>
  14. <div id="banner_wrapper">
  15. <div id="banner_content">
  16. <div id="banner_end">
  17. <div id="banner">
  18. <!-- <a href="#">Wt</a> -->
  19. </div>
  20. </div>
  21. </div>
  22. </div>
  23. <div id="main_wrapper" class="home">
  24. <div id="main_content">
  25. <div id="main_menu">
  26. ${menu}
  27. ${sidebar}
  28. </div>
  29. ${contents}
  30. <div class="clearall"></div>
  31. </div>
  32. </div>
  33. <div id="footer_wrapper">
  34. <div id="footer_content">
  35. <div id="footer_copyright">
  36. <a href="//www.emweb.be/">
  37. <img src="/css/wt/emweb_large.jpg" height="25" width="101"
  38. alt="Emweb.be" title="emweb.be"/></a>
  39. Solutions for web-based systems<br/>
  40. <a href="//www.emweb.be/">www.emweb.be</a>
  41. </div>
  42. <div id="footer_menu">
  43. <a href="//www.webtoolkit.eu/wt">Home</a>
  44. | <a href="//www.emweb.be/contact">Contact</a>
  45. </div>
  46. <div id="chat"></div>
  47. <script type="text/javascript">
  48. /*<![CDATA[*/
  49. setTimeout(function() {
  50. loadScript("//www.webtoolkit.eu/wt/examples/simplechat/chat.js?div=chat", null);
  51. }, 0);
  52. /* ]]> */
  53. </script>
  54. <div class="clearall"></div>
  55. </div>
  56. <script type="text/javascript">
  57. /*<![CDATA[*/
  58. (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  59. (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  60. m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  61. })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
  62. ga('create', 'UA-4345578-1', 'auto');
  63. ga('send', 'pageview');
  64. /* ]]> */
  65. </script>
  66. </div>
  67. </message>
  68. <message id="wt">Wt, C++ Web Toolkit</message>
  69. <message id="introduction">Introduction</message>
  70. <message id="blog">Blog</message>
  71. <message id="features">Features</message>
  72. <message id="documentation">Documentation</message>
  73. <message id="examples">Examples</message>
  74. <message id="download">Download</message>
  75. <message id="community">Support</message>
  76. <message id="other-language">!C++</message>
  77. <message id="hello-world">Hello world</message>
  78. <message id="charts">Charts</message>
  79. <message id="wt-homepage">Wt homepage</message>
  80. <message id="treeview">Treeview</message>
  81. <message id="git">Git explorer</message>
  82. <message id="chat">Chat</message>
  83. <message id="mail-composer">Mail composer</message>
  84. <message id="hangman">Hangman</message>
  85. <message id="widget-gallery">Widget gallery</message>
  86. <message id="home.news">
  87. <h3><span>News</span></h3>
  88. </message>
  89. <message id="home.latest-news">
  90. <h4><span>Latest News</span></h4>
  91. </message>
  92. <message id="home.historical-news">
  93. <h4><span>Historical News</span></h4>
  94. </message>
  95. <message id="source-browser-link">
  96. <a href="{1}">Browse the source code</a>
  97. </message>
  98. <message id="src-title">
  99. <div>
  100. </div>
  101. </message>
  102. <message id="home.intro">
  103. <h3><span>Wt: an introduction</span></h3>
  104. <p>Wt (pronounced as <i>witty</i>) is a C++ library for developing
  105. web applications.</p>
  106. <p>The API is <b>widget-centric</b> and uses well-tested patterns of
  107. desktop GUI development tailored to the web. To the developer, it
  108. offers abstraction of many web-specific implementation details,
  109. including client-server protocols (HTTP, Ajax, WebSockets), and frees
  110. the developer from tedious JavaScript manipulations of HTML and
  111. dealing with cross-browser issues. Instead, with Wt, you can focus on
  112. actual functionality with a rich set of feature-complete widgets.</p>
  113. <p>Unlike old-school page-based frameworks or current-day single-page
  114. JavaScript "frameworks", Wt allows you to create stateful applications
  115. that are at the same time highly interactive (using WebSockets and
  116. Ajax for everything) but still support plain HTML browsers or web
  117. crawlers using automatic <b>graceful degradation or progressive
  118. enhancement</b>. Things that are natural and simple with Wt would
  119. require an impractical amount of development effort otherwise:
  120. switching widgets using animations, while retaining clean URLs and
  121. browser navigation functions, or having a persistent chat widget open
  122. throughout the entire application, that even works in legacy browsers
  123. like Microsoft Internet Explorer 6.</p>
  124. <p>The library comes with an application server that acts as a
  125. stand-alone Http(s)/WebSocket server or integrates through FastCGI
  126. with other web servers.</p>
  127. <h4>Feature rich</h4>
  128. <ul>
  129. <li>Layout using <a
  130. href="//www.webtoolkit.eu/widgets/layout/html-templates">HTML
  131. templates</a> or intelligent <a
  132. href="//www.webtoolkit.eu/widgets/layout/layout-managers">layout
  133. managers</a> and themable look-and-feel, including support for <a
  134. href="http://getbootstrap.com">Twitter Bootstrap</a> versions 2 or 3.</li>
  135. <li>Create and maintain complexity by using and building reusable and
  136. self-contained widgets.</li>
  137. <li>Comes with a large set of feature-rich widgets that include <a href="//www.webtoolkit.eu/widgets/forms/">form
  138. widgets</a>, <a href="//www.webtoolkit.eu/widgets/trees-tables/mvc-table-views">table</a> and <a
  139. href="//www.webtoolkit.eu/widgets/trees-tables/mvc-tree-views">tree
  140. views</a>, <a
  141. href="//www.webtoolkit.eu/widgets/layout/dialogs">dialogs</a>, <a
  142. href="//www.webtoolkit.eu/widgets/navigation/popup-menu">popup
  143. menu's</a>, etc...</li>
  144. <li>Unified <a
  145. href="//www.webtoolkit.eu/widgets/graphics-charts">graphics</a>
  146. APIs, 2D (SVG, HTML5 Canvas, VML, PNG, and PDF) &amp; 3D (client side
  147. WebGL and server-side OpenGL).</li>
  148. <li>Feature rich <a
  149. href="//www.webtoolkit.eu/widgets/media/pdf-output">HTML
  150. to PDF renderer</a> for dynamic report generation.</li>
  151. <li>Elegant template-based C++ Database abstraction layer (Wt::Dbo)</li>
  152. <li>Built-in security against common vulnerabilities such as <a
  153. href="http://en.wikipedia.org/wiki/Cross-site_scripting">XSS (Cross-Site Scripting)</a> or <a
  154. href="http://en.wikipedia.org/wiki/Cross-site_request_forgery">CSRF
  155. (Cross-Site Request Forgery)</a></li>
  156. </ul>
  157. <h4>Typical use scenarios:</h4>
  158. <ul>
  159. <li><b>High performance, complex</b> web applications which are
  160. fully personalized (and thus cannot benefit from caching), fully
  161. Ajax enabled and at the same time entirely accessible and Search
  162. Engine Optimized.</li>
  163. <li>Web-based GUIs for <b>embedded systems</b> benefit from the low
  164. footprint of a C++ web application server.</li>
  165. <li>Web-based GUIs that require <b>integration with (existing) C++
  166. libraries</b>, for example for scientific or engineering
  167. applications, or <b>existing C++ desktop applications</b>.</li>
  168. </ul>
  169. </message>
  170. <message id="home.features">
  171. <h3><span>Features</span></h3>
  172. <h4>Core library</h4>
  173. <ul>
  174. <li>Supports major browsers (Firefox/Gecko, Internet Explorer,
  175. Safari, Chrome, Konqueror, and Opera) but also plain HTML
  176. browsers and web crawlers.</li>
  177. <li>Develop and deploy on Unix/GNU Linux or Microsoft Windows
  178. (Visual Studio) environments.</li>
  179. <li>Equal behavior with or without support for JavaScript or Ajax,
  180. as far as possible, by using graceful degradation or progressive
  181. enhancement.</li>
  182. <li>Efficient rendering and (sub-) millisecond latency.</li>
  183. <li>Integrated Unicode support and pervasive localization.</li>
  184. <li>Support for browser history navigation (back/forward buttons and
  185. bookmarks), clean URLs with HTML5 History if available, and
  186. search engine optimization with a unified behavior for plain HTML
  187. or Ajax sessions.</li>
  188. <li>High performance, suitable for embedded (Linux) devices, or
  189. energy-, space- and budget-friendly (virtual private) server
  190. deployments.</li>
  191. <li>Based on event-driven async I/O: sessions are not
  192. tied to threads, and neither do open connections block threads.
  193. Instead, threads are used only to improve concurrent request
  194. handling (or for reentrant event loops).</li>
  195. </ul>
  196. <h4>Event handling</h4>
  197. <ul>
  198. <li>Typesafe signal/slot API for responding to events.</li>
  199. <li>Listen for keyboard, mouse, focus, scroll or drag&amp;drop events,
  200. and get event details (such as mouse position, modifier buttons, or
  201. keyboard key).</li>
  202. <li>Automatic synchronization Automatically synchronizes form field data
  203. from browser to server and tracks server-side changes to be rendered
  204. in browser.</li>
  205. <li>Integrate with JavaScript libraries</li>
  206. <li>Timed events and server-initiated updates ("server push")</li>
  207. <li>Uses plain HTML CGI, Ajax or WebSockets</li>
  208. </ul>
  209. <h4>Native painting system</h4>
  210. <ul>
  211. <li>Unified 2D painting API which uses the browsers native (vector)
  212. graphics support (inline VML, inline SVG, or HTML5 canvas), or
  213. renders to common image formats (PNG, GIF, ...) or vector formats
  214. (SVG, PDF).</li>
  215. <li>Unified GL-based 3D painting API which leverages WebGL in the browser
  216. or server-side OpenGL (fallback).</li>
  217. </ul>
  218. <h4>Built-in security</h4>
  219. <ul>
  220. <li>Kernel-level memory protection protects against privacy issues
  221. arising from programming bugs, since sessions can be completely
  222. isolated from each other (in dedicated-process mode).</li>
  223. <li>Supports encryption and server authentication using Secure Sockets
  224. Layer (SSL) or Transport Layer Security (TLS) through HTTPS.</li>
  225. <li>Enables continuous use of HTTPS through low bandwidth
  226. requirements (fine-grained Ajax).</li>
  227. <li>Built-in Cross-Site Scripting (XSS) prevention. Rendered text is
  228. always filtered against potentially malicious code, making XSS
  229. attacks against Wt applications (close to) impossible.</li>
  230. <li>Not vulnerable to Cross-site Request Forgery (CSRF) because
  231. cookies for session tracking are optional, and even when used, they
  232. are never solely relied on for requests that trigger event handling
  233. code.</li>
  234. <li>Not vulnerable to breaking the application logic by skipping to
  235. a particular URL, since only those events exposed in the interface
  236. can be triggered.</li>
  237. <li>Session hijacking mitigation and risk prevention</li>
  238. <li>DoS mitigation</li>
  239. <li>A built-in authentication module implements best practices for
  240. authentication, and supports third party identity providers using
  241. OAuth 2.0, and (later) OpenID Connect</li>
  242. </ul>
  243. <h4>Object Relational Mapping library</h4>
  244. Wt comes with Wt::Dbo, a self-contained library which implements
  245. Object-Relational mapping, and thus a convenient way to interact with
  246. SQL databases from C++. Although features like optimistic concurrency
  247. control make this an ideal technology for a database driven web
  248. application (and it provides good integration with Wt's MVC classes),
  249. the library can also be used for other applications, and does not
  250. depend on Wt.
  251. The ORM library (see also <a
  252. href="//www.webtoolkit.eu/wt/doc/tutorial/dbo/tutorial.html">this
  253. tutorial</a>) has the following features:
  254. <ul>
  255. <li>No code generation, no macro hacks, no XML configuration, just
  256. modern C++!</li>
  257. <li>Uses a templated visitor pattern which requires a single
  258. template method to provide the mapping: DRY and as efficient as
  259. conceivable!</li>
  260. <li>You can indicate surrogate auto-incremental keys or map natural
  261. keys of any C++ type, which may also be composite (i.e. require more
  262. than one database field).</li>
  263. <li>Supports <a
  264. href="http://en.wikipedia.org/wiki/Optimistic_concurrency_control">
  265. optimistic concurrency control</a> using a version field.</li>
  266. <li>Maps Many-to-One and Many-to-Many relations to STL-compatible
  267. collections.</li>
  268. <li>Provides schema generation (aka DDL: data definition language)
  269. and CRUD operations (aka DML: data manipulation language).</li>
  270. <li>Prepared statements throughout.</li>
  271. <li>Each session tracks dirty objects and provides a first-level cache.</li>
  272. <li>Flexible querying which can query individual fields, objects, or
  273. tuples of any these (using Boost.Tuple).</li>
  274. <li>Use a single connection or share connection pools between
  275. multiple sessions from which connections are used only during an
  276. active transaction.</li>
  277. <li>Comes with Sqlite3, Firebird, MariaDB/MySQL and PostgreSQL
  278. backends, and an Oracle backend is also available on request.</li>
  279. </ul>
  280. <h4>Testing</h4>
  281. With Wt, event handling code constructs and manipulates a widget tree,
  282. which can easily be inspected by test code. Therefore, a <a href="
  283. //webtoolkit.eu/wt/doc/reference/html/classWt_1_1Test_1_1WTestEnvironment.html">test
  284. environment</a> allows your application to be instantiated and events
  285. to be simulated in absence of a browser, short-cutting the underlying
  286. request/response cycle that would otherwise require a simulated browser.
  287. <h4>Deployment</h4>
  288. <p>
  289. The library abstracts different deployment options as connectors
  290. libraries, which connect Wt with the outer world. Switching deployment
  291. option is a matter of (re)linking to one of these connector libraries!
  292. </p>
  293. <h5>a) Built-in httpd</h5>
  294. <ul>
  295. <li>Simple, high-performance web application server (multi-threaded,
  296. asynchronous I/O) based on the C++ asio library.</li>
  297. <li>Supports the HTTP(S) and WebSocket(S) protocols.</li>
  298. <li>Supports response chunking and compression.</li>
  299. <li>Single process (convenient for development and debugging), and
  300. embeddable in an existing application.</li>
  301. <li>Supports deployment behind a ProxyPass'ing (and if needed,
  302. load-balancing) web server.</li>
  303. <li>Available for both UNIX and Win32 platforms.</li>
  304. </ul>
  305. <h5>b) FastCGI</h5>
  306. <ul>
  307. <li>Integrates with most common web servers (apache, lighttpd).</li>
  308. <li>Different session-to-process mapping strategies.</li>
  309. <li>Hot deployment: new sessions use the new application version while
  310. older sessions may continue with their application version.</li>
  311. <li>Available only for UNIX platforms.</li>
  312. </ul>
  313. <h5>c) ISAPI</h5>
  314. <ul>
  315. <li>Integrates with Microsoft IIS server.</li>
  316. <li>Uses the ISAPI asynchronous API for maximum performance.</li>
  317. <li>Available for the Win32 platform.</li>
  318. </ul>
  319. </message>
  320. <message id="home.examples">
  321. <h3><span>Examples</span></h3>
  322. <p>Explore some live examples of Wt below.</p>
  323. <p>
  324. The source code of these (and many more) examples is included in the
  325. Wt source distribution. You may also browse through the source code
  326. of each example using the <a href="#/src">source code viewer</a>,
  327. following the link below each example.
  328. </p>
  329. <p>
  330. Cross-linked source code for these examples is also in
  331. <a href="//www.webtoolkit.eu/wt/doc/examples/html/modules.html" target="_blank">
  332. doxygen documentation (in a new window)</a>.
  333. </p>
  334. </message>
  335. <message id="home.examples.hello">
  336. <div>
  337. <h4 class="example">Hello world!</h4>
  338. <p>
  339. <a href="//www.webtoolkit.eu/wt/examples/hello/hello.wt" class="run" target="_blank">
  340. <img src="/icons/green-play.png" style="vertical-align: top"/> Run example
  341. </a>
  342. </p>
  343. <p>This simple example illustrates most of the basic Wt concepts:</p>
  344. <ul>
  345. <li>
  346. How to make a minimal Wt application, using <b>WRun()</b> to start
  347. the web server, and a function to create a new <a
  348. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WApplication.html"
  349. target="_blank">WApplication</a>, corresponding to a new session.
  350. </li>
  351. <li>
  352. <b>Creating widgets</b>, and adding them to <b>the widget tree</b>.
  353. </li>
  354. <li>
  355. Reacting to events using the <b>signal/slot</b> mechanism.
  356. </li>
  357. <li>
  358. Reading user input and updating widgets.
  359. </li>
  360. </ul>
  361. <p>For a thorough (although slightly out-dated) explanation of the
  362. hello world example, see also the <a
  363. href="http://www.codeguru.com/cpp/i-n/internet/browsercontrol/article.php/c15275/"
  364. target="_blank">nice introduction to Wt</a> written by Victor Venkman.</p>
  365. </div>
  366. </message>
  367. <message id="home.examples.wt">
  368. <div>
  369. <h4 class="example">Wt homepage</h4>
  370. <p>We eat our own dog food: this website itself is a Wt example. </p>
  371. <p>
  372. Not really the interactive application Wt was designed for, the
  373. homepage illustrates how Wt also makes excellent content-driven
  374. websites. To that extent, Wt supports pretty URLs all the same for
  375. both Ajax and plain HTML sessions (leveraging HTML5 History support
  376. if possible), useful for browser history navigation,
  377. bookmarks, and search engine optimization.
  378. </p>
  379. <p>
  380. Navigation is provided by a <a
  381. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WMenu.html"
  382. target="_blank">WMenu</a> and <a
  383. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WTabWidget.html"
  384. target="_blank">WTabWidget</a>. These widgets share the same feature
  385. set. For Ajax sessions, they support <b>pre-loading</b> and <b>lazy
  386. loading</b> of the contents associated with each item. Pre-loaded
  387. contents does not increase the load time because the Wt rendering
  388. engine always optimizes the response time by only transmitting
  389. visual widgets or changes first. Everything invisible (such as the
  390. contents for other pre-loaded menu items) is transmitted in the
  391. background, after rendering the visible contents.
  392. </p>
  393. <p>
  394. Menu navigation is implemented using C++ stateless slots, and
  395. therefore results in <b>client-side</b> event handling
  396. code. Optionally, CSS3 animations can be used to animate the
  397. transition of contents managed by a <a
  398. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WStackedWidget.html"
  399. target="_blank">WStackedWidget</a>.
  400. </p>
  401. <p>
  402. URLs are associated with each menu/tab entry, and in this way
  403. participate in browser navigation history and bookmarking. When the
  404. user browses through the history, the menu reacts
  405. to <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WApplication.html#a674fd6a2522d66d07908e8f3d82424a9"
  406. target="_blank">navigation events</a>. Similarly, when a user
  407. bookmarks a URL to revisit it later, or follows an external link to
  408. your application, the menu reacts to the initial internal
  409. path. All-together this generates a decentralized "routing
  410. framework" for pretty URLs that works equally well for Ajax as plain
  411. HTML sessions.
  412. </p>
  413. <p>
  414. The chat widget sitting at the bottom is actually part of the <a
  415. href="#/examples/chat">chat example</a>.
  416. </p>
  417. </div>
  418. </message>
  419. <message id="home.examples.treeview">
  420. <div>
  421. <h4 class="example">Treeview</h4>
  422. <p>
  423. <a href="//www.webtoolkit.eu/wt/examples/treeview-dragdrop/treeview-dragdrop.wt" class="run" target="_blank">
  424. <img src="/icons/green-play.png" style="vertical-align: top"/> Run example
  425. </a>
  426. </p>
  427. This example illustrates some MVC functionality provided by builtin
  428. Views (WTreeView, WTableView and PieChart) and models.
  429. <ul>
  430. <li>
  431. The example uses <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WTreeView.html"
  432. target="_blank">WTreeView</a>
  433. and <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WTableView.html"
  434. target="_blank">WTableView</a> widgets for rendering a Model's
  435. data in a tree or a table.
  436. </li>
  437. <li>
  438. A <a
  439. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WSortFilterProxyModel.html"
  440. target="_blank">WSortFilterProxyModel</a>
  441. implement sorting and filtering for another model.
  442. </li>
  443. <li>
  444. These item views have support for drag and drop of a selection of items.
  445. </li>
  446. <li>
  447. You can use nested layout managers (horizontal and
  448. vertical
  449. <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WBoxLayout.html" target="_blank">
  450. WBoxLayout</a>)
  451. for an automatic window-filling layout, with optional resize handles.
  452. </li>
  453. <li>
  454. Modal (and non-modal) <a
  455. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WDialog.html"
  456. target="_blank">dialogs</a> can be used to prompt for input.
  457. </li>
  458. <li>
  459. You may show a context-sensitive
  460. <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WPopupMenu.html" target="_blank">
  461. WPopupMenu</a>.
  462. </li>
  463. </ul>
  464. </div>
  465. </message>
  466. <message id="home.examples.chart">
  467. <div>
  468. <h4 class="example">Charts example</h4>
  469. <p>
  470. <a href="//www.webtoolkit.eu/wt/examples/charts/charts.wt" class="run" target="_blank">
  471. <img src="/icons/green-play.png" style="vertical-align: top"/> Run example
  472. </a>
  473. </p>
  474. <p>This example demonstrates the <a
  475. href="//www.webtoolkit.eu/wt/doc/reference/html/group__charts.html" target="_blank">Wt
  476. charting widgets</a> that are implemented on top of Wt's cross-browser
  477. painting API. This painting API uses built-in browser support for
  478. generating high quality graphics. Depending on the browser,
  479. inline VML, inline SVG, HTML5 canvas, or a PNG image is used to
  480. render painted contents in a <a
  481. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WPaintedWidget.html"
  482. target="_blank">WPaintedWidget</a>.
  483. </p>
  484. <p>This example also demonstrates how a Model can be shared by several
  485. Views, and pass modification events to each connected View. The <a
  486. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WTableView.html"
  487. target="_blank">table view</a> and the chart implement a <i>View</i>
  488. on the same <a
  489. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WAbstractItemModel.html"
  490. target="_blank">item model</a>.</p>
  491. </div>
  492. </message>
  493. <message id="home.examples.git">
  494. <div>
  495. <h4 class="example">Git explorer</h4>
  496. <p>
  497. <a href="//www.webtoolkit.eu/wt/examples/gitmodel/gitview.wt" class="run" target="_blank">
  498. <img src="/icons/green-play.png" style="vertical-align: top"/> Run example
  499. </a>
  500. </p>
  501. <p>
  502. This example serves as a demo for a custom model implementation which can
  503. be used by Wt's item View classes, such as
  504. <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WTreeView.html" target="_blank">
  505. WTreeView</a>.
  506. </p>
  507. <p>
  508. A <a
  509. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WStandardItemModel.html"
  510. target="_blank">WStandardItemModel</a> can be populated with data
  511. retrieved from for example a database. A draw-back is however that
  512. all data must be retrieved in advance and is kept in session
  513. memory. By reimplementing <a
  514. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WAbstractItemModel.html"
  515. target="_blank">WAbstractItemModel</a>, you can however implement a
  516. model that reads (or computes) the data only when needed, and
  517. provides a trade-off between keeping data in memory or fetching it
  518. from the source.</p>
  519. <p>In this example, we implement a tree model that navigates a <a
  520. href="http://git-scm.com/">git repository</a>. The model lazy-stores
  521. folder nodes in memory, but reads all other data directly from
  522. git. Initially we thought the SHA-1 id's could be used, but folders
  523. with the same content in different places of the git repository have
  524. the same SHA-1 ID's while representing different <a
  525. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WModelIndex.html"
  526. target="_blank">model indexes</a>.
  527. </p>
  528. </div>
  529. </message>
  530. <message id="home.examples.composer">
  531. <div>
  532. <h4 class="example">Mail composer</h4>
  533. <p>
  534. <a href="//www.webtoolkit.eu/wt/examples/composer/composer.wt" class="run" target="_blank">
  535. <img src="/icons/green-play.png" style="vertical-align: top"/> Run example
  536. </a>
  537. </p>
  538. <p>
  539. This example implements a GMail-like mail composer and shows among
  540. other things how to upload files asynchronously, showing a
  541. cross-browser upload progress bar and with support for multiple
  542. files.
  543. </p>
  544. <ul>
  545. <li>
  546. The <i>ContactSuggestions</i> class provides auto-completion of
  547. the addressees in the To: Cc: and Bcc: fields. The widget
  548. derives from <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WSuggestionPopup.html"
  549. target="_blank">WSuggestionPopup</a>.
  550. </li>
  551. <li>
  552. The <i>AttachmentEdit</i> widget uses a <a
  553. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WFileUpload.html"
  554. target="_blank">WFileUpload</a> to asynchronously
  555. upload files. The upload <a
  556. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WProgressBar.html"
  557. target="_blank">progress bar</a> will work even in IE6.
  558. </li>
  559. <li>
  560. The <i>Option</i> and <i>OptionList</i> classes show how
  561. stateless slots, a trick to handle events client-side but
  562. implement them still in C++, may be used even when the behaviour
  563. is not entirely stateless. In this case, the hiding of an Option
  564. affects neighboring visible options: an option needs a separator
  565. only if there is a neighbouring option. By <b>invalidating the
  566. stateless slot implementations</b> when state has changed, we
  567. can still use a stateless slot implementation and enjoy
  568. client-side event handling performance!
  569. </li>
  570. </ul>
  571. </div>
  572. </message>
  573. <message id="home.examples.chat">
  574. <div>
  575. <h4 class="example">Simple Chat</h4>
  576. <p>
  577. <a href="//www.webtoolkit.eu/wt/examples/simplechat/simplechat.wt" class="run" target="_blank">
  578. <img src="/icons/green-play.png" style="vertical-align: top"/> Run example
  579. </a> (or ventilate your thoughts down here)
  580. </p>
  581. <p>
  582. This example implements a simple chat client and server. Using
  583. <b>server-initiated updates</b>, you can easily push events from one
  584. user to other users. Server-initiated updates are implemented using
  585. Ajax long polling or HTML5 WebSockets.
  586. </p>
  587. <p>
  588. It also illustrates nice benefits of a class-based approach to web
  589. application development: you can easily instantiate the same widget
  590. class multiple times. The SimpleChatClient widget may be reused just
  591. as you reuse basic Wt widgets such as a push button.
  592. </p>
  593. <p>
  594. The chat application is also available as a <i>Widget</i> which can
  595. be embedded in another page (very much like how you integrate a
  596. google maps widget inside another application). In this case, we've
  597. embedded the chat also in this very homepage as follows:
  598. </p>
  599. <pre> &lt;div id="chat"&gt;&lt;/div&gt;
  600. &lt;script src="//www.webtoolkit.eu/wt/examples/simplechat/chat.js?div=chat"&gt;&lt;/script&gt;</pre>
  601. <p>
  602. This uses Cross-Origin Ajax/WebSocket requests (if the browser
  603. supports this, falling back to old tricks if not) to communicate
  604. from a HTML origin page to a server hosting the Widget possibly from
  605. a different domain.
  606. </p>
  607. <p>
  608. Interactive applications like these, which allow users to post HTML
  609. text to other users, are notorious for <b>cross-site-scripting (XSS)
  610. attacks</b>: a user enters malicious (javascript) code as part of
  611. his message. When another user renders this message, it may transmit
  612. unwanted private information retrieved from, for example, browser
  613. cookies. Wt prevents such attacks completely, and without any
  614. responsibility to the developer, since widgets such as WText ensure
  615. that what is displayed is only passive text, discarding anything
  616. that is not strictly text.
  617. </p>
  618. </div>
  619. </message>
  620. <message id="home.examples.hangman">
  621. <div>
  622. <h4 class="example">Hangman</h4>
  623. <p>
  624. <a href="//www.webtoolkit.eu/wt/examples/hangman-game/hangman.wt" class="run" target="_blank">
  625. <img src="/icons/green-play.png" style="vertical-align: top"/> Run example
  626. </a>
  627. </p>
  628. <p>
  629. This example implements a simple well-known game, including a user
  630. ranking system, which is persisted to a database using Wt::Dbo.
  631. </p>
  632. <p>
  633. Some of the things illustrated in this example:
  634. </p>
  635. <ul>
  636. <li>
  637. Different approaches to layout: using an <a
  638. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WTemplate.html"
  639. target="_blank">HTML template</a>, a <a
  640. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WBoxLayout.html"
  641. target="_blank">layout manager</a>, or by compositing basic
  642. widgets and CSS.
  643. </li>
  644. <li>
  645. Using hidden content to optimize the user experience by preloading
  646. contents, used in this game to preload the various images used to
  647. show the hanging man.
  648. </li>
  649. <li>
  650. Navigation is implemented using <a
  651. href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WAnchor.html"
  652. target="_blank">WAnchor</a> which reference an internal path.
  653. Action is taken by reacting to internal path changes.
  654. </li>
  655. <li>
  656. The example uses <a
  657. href="//www.webtoolkit.eu/wt/doc/reference/html/group__auth.html">the
  658. authentication module (Wt::Auth)</a> to authenticate users using a
  659. username/password, or using Google's beta OAuth 2.0 service.
  660. </li>
  661. <li>
  662. A database which contains user information is accessed and updated
  663. using <a href="//www.webtoolkit.eu/wt/doc/tutorial/dbo/tutorial.html">Wt::Dbo</a>.
  664. </li>
  665. </ul>
  666. <!--<p>For a thorough explanation of the hangman example, see also the ARTICLE</p>-->
  667. </div>
  668. </message>
  669. <message id="home.examples.widgetgallery">
  670. <div>
  671. <h4 class="example">Widget gallery</h4>
  672. <p>
  673. <a href="//www.webtoolkit.eu/widgets" class="run" target="_blank">
  674. <img src="/icons/green-play.png" style="vertical-align: top"/> Go to widget gallery
  675. </a>
  676. </p>
  677. <p>
  678. This example demonstrates most widgets provided by Wt, in addition to
  679. other aspects such as event handling and layout classes. Useful as an
  680. executable reference to widgets and features provided by the library.
  681. </p>
  682. </div>
  683. </message>
  684. <message id="home.download">
  685. <h3><span>Download</span></h3>
  686. </message>
  687. <message id="home.download.license">
  688. <h4>License and Pricing</h4>
  689. <p>Wt may be used using either an Open Source or a Commercial License.</p>
  690. <p>If you wish to use the library using the <b>GNU General Public
  691. License (GPL)</b>, you may build a web application with Wt and deploy
  692. it, but per the terms of the GPL, you are obliged to make the source
  693. code available to anyone who you give the application to install the
  694. application on its own server. This also applies to redistribution of
  695. the Wt library, in original or modified form.</p>
  696. <p><b>The Commercial License</b> has no such limitations: you may
  697. redistribute applications developed with Wt without needing to
  698. redistribute the source code. The license is a royalty-free, perpetual
  699. license for one developer to use the API of Wt (respectively Wt::Dbo)
  700. for application development, using the latest version of Wt or any
  701. version released during one year.
  702. </p>
  703. <table class="versions">
  704. <tr class="trh">
  705. <th></th>
  706. <th class="product">Dbo</th>
  707. <th class="product">Wt + Dbo</th>
  708. </tr>
  709. <tr class="r0">
  710. <th>Widget library</th>
  711. <td></td>
  712. <td>+</td>
  713. </tr>
  714. <tr class="r1">
  715. <th>Application server</th>
  716. <td></td>
  717. <td>+</td>
  718. </tr>
  719. <tr class="r0">
  720. <th>HTTP + WebSockets server</th>
  721. <td></td>
  722. <td>+</td>
  723. </tr>
  724. <tr class="r1">
  725. <th>Charting Module</th>
  726. <td></td>
  727. <td>+</td>
  728. </tr>
  729. <tr class="r0">
  730. <th>XHTML Rendering Module</th>
  731. <td></td>
  732. <td>+</td>
  733. </tr>
  734. <tr class="r1">
  735. <th>C++ ORM</th>
  736. <td>+</td>
  737. <td>+</td>
  738. </tr>
  739. <tr class="r0">
  740. <th class="indent">Sqlite3 driver</th>
  741. <td>+</td>
  742. <td>+</td>
  743. </tr>
  744. <tr class="r1">
  745. <th class="indent">PostgreSQL driver</th>
  746. <td>+</td>
  747. <td>+</td>
  748. </tr>
  749. <tr class="r0">
  750. <th class="indent">Firebird driver</th>
  751. <td>+</td>
  752. <td>+</td>
  753. </tr>
  754. <tr class="r1">
  755. <th class="indent">MariaDB/MySQL driver</th>
  756. <td>+</td>
  757. <td>+</td>
  758. </tr>
  759. <tr class="r0">
  760. <th class="indent">Oracle driver</th>
  761. <td colspan="2"><a href="mailto:sales@emweb.be">Contact us</a></td>
  762. </tr>
  763. <tr class="separate r1">
  764. <th>License</th>
  765. <td></td>
  766. <td></td>
  767. </tr>
  768. <tr class="r0">
  769. <th class="indent">
  770. GNU General Public License
  771. </th>
  772. <td>free</td>
  773. <td>free</td>
  774. </tr>
  775. <tr class="r1">
  776. <th class="indent multiline">
  777. Commercial License
  778. </th>
  779. <td class="multiline">
  780. <div><span class="price">&euro;175</span> <span class="cart" /></div>
  781. <div><a href="//www.webtoolkit.eu/wt/license/WtDbo%20License%20Agreement.pdf" class="smallprint">(license text)</a></div>
  782. </td>
  783. <td class="multiline">
  784. <div><span class="price">&euro;599</span> <span class="cart" /></div>
  785. <div><a href="//www.webtoolkit.eu/wt/license/Wt%20License%20Agreement.pdf" class="smallprint">(license text)</a></div>
  786. </td>
  787. </tr>
  788. </table>
  789. There is also an Oracle driver for Wt::Dbo, which is sold separately and
  790. can be used only in conjunction with a Commercial License for Wt::Dbo.
  791. </message>
  792. <message id="home.download.packages">
  793. <h4><span>Available packages</span></h4>
  794. </message>
  795. <message id="home.download.version"><b>Version</b></message>
  796. <message id="home.download.date"><b>Date</b></message>
  797. <message id="home.download.description"><b>Description</b></message>
  798. <message id="home.download.other">
  799. <p>
  800. If you are looking to use Wt using <b>MSVC on Windows platforms</b>,
  801. then you can save yourself some hassle to build Wt with its optional
  802. dependencies from source, and download one of the <a
  803. href="https://github.com/kdeforche/wt/releases">binary builds
  804. instead</a> (<a
  805. href="http://sourceforge.net/projects/witty/files/wt/">old releases</a>)
  806. which allow you to quickly experiment with the examples
  807. that ship with Wt.
  808. </p>
  809. <p>
  810. Similarly, if you are on <b>Ubuntu</b>, you can install a reasonably
  811. recent version of Wt from official packages. The wiki contains more
  812. details on <a
  813. href="http://redmine.emweb.be/projects/wt/wiki/Installing_Wt_on_Ubuntu">installing
  814. Wt on Ubuntu</a>, including instructions on how to build Wt from
  815. source or getting packages for the most recent Wt releases.
  816. </p>
  817. <div class="fragment">
  818. <pre class="fragment">
  819. $ sudo apt-get install witty witty-dev witty-doc witty-dbg witty-examples</pre>
  820. </div>
  821. <p>
  822. The last package (<tt>witty-examples</tt>) installs the examples
  823. in <tt>/usr/lib/Wt/examples</tt>. You can run each of them like this:
  824. </p>
  825. <div class="fragment">
  826. <pre class="fragment">$ /usr/lib/Wt/examples/hello/hello</pre>
  827. </div>
  828. <p>Older releases are still available at
  829. <a href="http://sourceforge.net/projects/witty/files/wt/">sourceforge.net</a>.
  830. </p>
  831. <h4>The Wt installer: winst</h4>
  832. If you are curious about Wt and would like to try it out but your OS
  833. or distribution does not provide an up-to-date package, then this may
  834. be just what you need. This package will download and build Wt and its
  835. dependencies in a <b>UNIX(-like) environment</b>, and provides also
  836. a script to run the examples.
  837. <p>
  838. This requires <tt>CMake</tt> and <tt>GNU make</tt> and will try to
  839. download software using <tt>wget</tt>.
  840. </p>
  841. <p>
  842. Download the package
  843. (<a href="//www.webtoolkit.eu/packages/winst-0.4.tar.gz">winst-0.4.tar.gz</a>)
  844. or get the latest git version:
  845. <div class="fragment">
  846. <pre class="fragment">$ git clone git://github.com/kdeforche/winst.git</pre>
  847. </div>
  848. </p>
  849. <h4>System requirements</h4>
  850. For building and installing the latest version of Wt, you need at
  851. least the following two packages:
  852. <ul>
  853. <li><a href="http://www.cmake.org/">CMake</a> cross-platform make configure
  854. utility.<br />
  855. CMake &gt;= 2.6 is preferred (although by the act of a miracle,
  856. 2.4 still works).
  857. </li>
  858. <li>
  859. The indispensable <a href="http://www.boost.org/"> boost C++
  860. library</a>: boost-1.41 or later. Older boost versions (as old as 1.36)
  861. may also be used, but some functionality will be missing
  862. (JSON parsing and a better SQL query parsing for Wt::Dbo). <br />
  863. The following boost libraries (which are not headers only) are
  864. needed: <tt>boost_date_time</tt>, <tt>boost_regex</tt>,
  865. <tt>boost_program_options</tt>, <tt>boost_signals</tt>,
  866. <tt>boost_random</tt>, <tt>boost_system</tt>, and optionally (but
  867. highly recommended) <tt>boost_thread</tt>.
  868. </li>
  869. </ul>
  870. The following packages are optional, and availability enables additional
  871. features in Wt:
  872. <ul>
  873. <li><a href="http://www.openssl.org/">OpenSSL</a>: if available,
  874. then the HTTPS protocol will be supported by the web client
  875. (<a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1Http_1_1Client.html">Http::Client</a>) and web server (wthttp connector)
  876. </li>
  877. <li><a href="https://github.com/libharu/libharu/wiki">libharu</a>: if
  878. available, a
  879. <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WPdfImage.html">WPdfImage</a>
  880. paint device will be included, which provides rendering support for PDF
  881. documents. For more complete support for TrueType fonts and Unicode, you'll
  882. want <a href="https://github.com/libharu/libharu">the latest git version</a>
  883. and probably also libpango (see further) for accurate font/glyph
  884. selection.
  885. </li>
  886. <li><a href="http://www.graphicsmagick.org/">GraphicsMagick</a>: if
  887. available,
  888. a <a href="//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WRasterImage.html">WRasterImage</a>
  889. paint device will be included, which outputs to raster images like PNG
  890. or GIF.</li>
  891. <li><a href="http://www.pango.org/">pango</a> (LGPL): if available,
  892. text rendering for WPdfImage and WRasterImage will be assisted by
  893. this library for TrueType font selection, taking into
  894. consideration both the font face and unicode coverage.</li>
  895. <li>
  896. <a href="http://www.postgresql.org/">PostgreSQL</a>, <a
  897. href="http://www.mysql.com/">MySQL</a>/<a
  898. href="http://mariadb.org/">MariaDB</a>, and <a
  899. href="http://firebirdsql.org">Firebird</a>: if available,
  900. connectors for these databases for the ORM library (<a
  901. href="//www.webtoolkit.eu/wt/doc/tutorial/dbo/tutorial.html">
  902. Wt::Dbo</a>) will be built (alongside the Sqlite3 connector which
  903. is distributed with Wt).
  904. </li>
  905. </ul>
  906. <p>The other requirements depend on the connector support you would
  907. like. The connector is what makes your Wt application communicate with
  908. the browser:</p>
  909. <h5>For FastCGI (Unix only):</h5>
  910. <ul>
  911. <li>Apache 1 or 2, or another web server which supports the FastCGI
  912. protocol.</li>
  913. <li>
  914. <a href="http://www.fastcgi.com/#TheDevKit">FastCGI development kit</a>
  915. : fcgi-2.4.0
  916. </li>
  917. <li>
  918. When using apache:
  919. Apache <a href="http://www.fastcgi.com/dist/mod_fastcgi-2.4.6.tar.gz">mod_fastcgi</a>:
  920. mod_fastcgi-2.4.x.<br />Alternatively you may
  921. use <a href="http://httpd.apache.org/download.cgi#mod_fcgid">mod_fcgid</a>:
  922. mod_fcgid-2.3.5.
  923. </li>
  924. </ul>
  925. <h5>For the built-in http deamon, wthttpd:</h5>
  926. <ul>
  927. <li>Optionally, libz (for compression-over-HTTP) and openssl (for
  928. HTTPS support).
  929. </li>
  930. </ul>
  931. <h5>For ISAPI (Win32 only):</h5>
  932. <ul>
  933. <li>The ISAPI connector only works for deploying Wt applications withing a
  934. Microsoft IIS server.</li>
  935. </ul>
  936. Follow the <a
  937. href="//www.webtoolkit.eu/wt/doc/reference/html/InstallationUnix.html">Installation
  938. instructions</a> to build Wt and run the examples, or see if your
  939. platform is listed in the <a
  940. href="http://redmine.webtoolkit.eu/projects/wt/wiki/Wt_Installation">platform specific
  941. installation instructions</a>.
  942. <h4>Git repository</h4>
  943. <a href="https://github.com/kdeforche/wt"><img style="display: block; width: 80px; float: right" src="https://github.com/github/media/blob/master/octocats/octocat.png?raw=true"></img></a>
  944. <p>If you want to keep track of the latest changes, or participate in
  945. Wt development, you may want to work from
  946. the <a href="https://github.com/kdeforche/wt">github
  947. repository</a>.</p>
  948. <p>
  949. Alternatively checkout the repository using:
  950. <div class="fragment">
  951. <pre class="fragment">$ git clone git://github.com/kdeforche/wt.git</pre>
  952. </div>
  953. </p>
  954. </message>
  955. <message id="home.community">
  956. <h3><span>Support</span></h3>
  957. <h4>Support and Training</h4>
  958. <p>
  959. You can get <a href="//www.emweb.be/services">support and
  960. training</a> directly from the library authors, with a
  961. guaranteed three-day response time.
  962. </p>
  963. <p>
  964. Community help is available in the <a
  965. href="http://redmine.webtoolkit.eu/projects/wt/boards">public
  966. forums</a>. Until September 2009, there was only a <a
  967. href="mailto:witty-interest@lists.sourceforge.net">mailing list</a>
  968. (<a
  969. href="http://lists.sourceforge.net/lists/listinfo/witty-interest">how
  970. to join</a>), and the old dogs haven't left yet. You may search or
  971. browse the mailing list archives using the <a
  972. href="http://gmane.org/info.php?group=gmane.comp.web.witty.general">Gmane
  973. gateway</a> (kudos to Pau Garcia i Quiles for setting this up).
  974. </p>
  975. <p>
  976. To get up to speed with Wt and/or Wt::Dbo, you may also obtain <a
  977. href="//www.emweb.be/services">training</a> directly from
  978. the library authors.
  979. </p>
  980. <h4>Authors</h4>
  981. <p>
  982. The software was originally developed by <a
  983. href="mailto:koen@emweb.be">Koen Deforche</a>, and is currently
  984. maintained by <a href="//www.emweb.be/">Emweb bvba</a>.</p>
  985. <p>We are greateful to these projects from which we borrowed code:</p>
  986. <ul>
  987. <li>The built-in httpd is based on an example of the <a
  988. href="http://asio.sourceforge.net/">asio C++
  989. library</a>, developed by Christopher M. Kohlhoff. <a
  990. href="http://www.boost.org/LICENSE_1_0.txt">Boost Software License</a></li>
  991. <li>The <a href="http://rapidxml.sourceforge.net/">RapidXML</a>
  992. library by Marcin Kalicinski. <a
  993. href="http://www.boost.org/LICENSE_1_0.txt">Boost Software License</a></li>
  994. <li>The authentication module
  995. contains <a href="http://www.openwall.com/crypt/">bcrypt</a>
  996. and <a href="http://www.openwall.com/passwdqc/">passwdqc</a> by Solar
  997. Designer. <a href="http://www.openwall.com/crypt/">Public
  998. domain.</a></li>
  999. </ul>
  1000. <p>
  1001. Other independent contributors include: Richard Ulrich, Gaetano
  1002. Mendola, Thomas Suckow, Hilary Cheng, Dmitriy Igrishin, Daniel Derr,
  1003. Omer Katz, and Lukasz Matuszewski, and many others (see the Changelog).
  1004. </p>
  1005. <h4>Wiki</h4>
  1006. <p>
  1007. There is a community-run <a
  1008. href="http://redmine.webtoolkit.eu/projects/wt/wiki">Wt Wiki</a> with useful
  1009. information, including installation notes for several Linux
  1010. distributions.
  1011. </p>
  1012. <h4>Contributions</h4>
  1013. <p>Development of Wt is sponsored by the following companies and
  1014. organisations:</p>
  1015. <p>
  1016. <table>
  1017. <tr>
  1018. <td class="sponsor-logo"><a href="//www.emweb.be/">
  1019. Emweb bvba</a>
  1020. </td>
  1021. <td class="sponsor-role">
  1022. Creators, official maintainers, and support
  1023. </td>
  1024. </tr>
  1025. <tr>
  1026. <td class="sponsor-logo">
  1027. <a href="http://www.eurofer.be/">
  1028. Eurofer</a>
  1029. </td>
  1030. <td class="sponsor-role">
  1031. Sponsored the development of the charting library, WTreeView and
  1032. hierachical item models.
  1033. </td>
  1034. </tr>
  1035. </table>
  1036. </p>
  1037. <p>User contributions are welcomed, ranging from simple patches to
  1038. widgets, widget sets, and core improvements.</p>
  1039. <p>However, because Wt is dual-licensed under an Open Source and
  1040. commercial license, and to legally protect the code base of Wt as a
  1041. whole by one entity without having to worry about the copyrights for
  1042. different pieces, we require a copyright assignment from contributors
  1043. to <a href="//www.emweb.be/">Emweb</a> before
  1044. accepting the contribution.</p>
  1045. <h4>Translations</h4>
  1046. The Chinese translation of the homepage was provided by Zhimin Song.
  1047. <h4>Sourceforge</h4>
  1048. <a href="http://sourceforge.net"><img src="https://sflogo.sourceforge.net/sflogo.php?group_id=153710&amp;type=1" style="vertical-align:middle" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
  1049. The Wt project is hosted at sourceforge <a href="http://sourceforge.net/projects/witty/">here</a>.
  1050. </message>
  1051. <message id="home.other-language">
  1052. <h3><span>!C++ ?</span></h3>
  1053. <p>You like the library functionality, but do not grok C++ for your
  1054. project?</p>
  1055. <p>Do not despair. Wt exists in a native variant or through bindings
  1056. in other languages:
  1057. <ul class="languages">
  1058. <li>
  1059. <div>
  1060. <img class="java-language-icon" src="/icons/java-logo.png" alt="Java"></img>
  1061. You can use <a href="//www.webtoolkit.eu/jwt">JWt</a>, a native <b>Java</b> version of Wt
  1062. developed and maintained together with the C++ version. It has, with
  1063. few exceptions, the same features as Wt, but runs natively in the JVM
  1064. and can be deployed into any Servlet container.
  1065. </div>
  1066. <br style="clear: both" />
  1067. </li>
  1068. <li>
  1069. <div>
  1070. <img class="language-icon" src="/icons/ruby-logo-R.png" alt="Ruby"></img>
  1071. Richard Dale is
  1072. maintaining <a href="http://github.com/rdale/wtruby/tree/master">WtRuby</a>,
  1073. <b>Ruby</b> bindings to Wt, using the same framework used for generating Ruby
  1074. bindings to Qt and KDE.
  1075. </div>
  1076. <br style="clear: both" />
  1077. </li>
  1078. <li>
  1079. <div>
  1080. <img class="language-icon" src="/icons/clojure-logo.png" alt="Clojure"></img>
  1081. Leveraging the JVM's support for other languages, such
  1082. as <b>Clojure</b>, a LISP variant, Ralph Moritz is experimenting
  1083. with <a href="http://lispetc.posterous.com/hello-jwt-from-clojure">using
  1084. JWt from within Clojure</a>, documenting his experience in his blog
  1085. and eventually developing a small support library.
  1086. </div>
  1087. <br style="clear: both" />
  1088. </li>
  1089. <li>
  1090. <div>
  1091. <img class="language-icon" src="/icons/jython-logo.png" alt="Jython"></img>
  1092. Albert Cervera i Areny is experimenting to use JWt from <b>Jython</b>,
  1093. another language running on the JVM. He documents how to create and run
  1094. the "Hello World!" program in Jython in <a href="http://www.nan-tic.com/en/from-pyqt-to-jythonjwt-setting-up-the-environment">this blog post</a>.
  1095. </div>
  1096. <br style="clear: both" />
  1097. </li>
  1098. </ul>
  1099. </p>
  1100. </message>
  1101. <message id="home.documentation">
  1102. <h3><span>Documentation</span></h3>
  1103. <h4>Build and install</h4>
  1104. <p>
  1105. Generic installation instructions (UNIX)
  1106. are <a href="//www.webtoolkit.eu/wt/doc/reference/html/InstallationUnix.html">here</a>, which
  1107. are also included in the source package (INSTALL or INSTALL.html).</p>
  1108. <p>
  1109. In addition, the <a href="http://redmine.webtoolkit.eu/projects/wt/wiki">Wt
  1110. Wiki</a> has a section dedicated
  1111. to <a href="http://redmine.webtoolkit.eu/projects/wt/wiki/Wt_Installation">platform
  1112. specific installation notes</a>.
  1113. </p>
  1114. <h4>Introduction and tutorials</h4>
  1115. <ul>
  1116. <li>Learn about the benefits of Wt compared to traditional web
  1117. application frameworks using our <a
  1118. href="//www.webtoolkit.eu/doc/Wt-WhitePaper.pdf">white
  1119. paper</a>.</li>
  1120. <li>The <a
  1121. href="//www.webtoolkit.eu/wt/doc/tutorial/wt.html">online
  1122. tutorial</a> (<a
  1123. href="//www.webtoolkit.eu/wt/doc/tutorial/wt.pdf">download
  1124. PDF</a>) brings you up to speed on developing web applications using
  1125. Wt (revised December 2011).</li>
  1126. <li>The ORM framework (Wt::Dbo) is covered in a separate <a
  1127. href="//www.webtoolkit.eu/wt/doc/tutorial/dbo.html">online
  1128. tutorial</a> (<a
  1129. href="//www.webtoolkit.eu/wt/doc/tutorial/dbo.pdf">download
  1130. PDF</a>) (revised July 2011).</li>
  1131. <li>Dr Dobbs Journal has a good <a href="http://www.ddj.com/cpp/206401952">
  1132. introductary article on Wt</a> (February 2008).</li>
  1133. <li>The reference manual contains a <a
  1134. href="//www.webtoolkit.eu/wt/doc/reference/html/overview.html">library
  1135. overview</a> which is recommended reading with information about
  1136. configuration and deployment options.</li>
  1137. <li>Victor Venkman wrote a
  1138. <a href="http://www.codeguru.com/cpp/i-n/internet/browsercontrol/article.php/c15275/">nice introduction to Wt</a>, with a closer examination of
  1139. the <a href="#/examples/">hello world example</a>.</li>
  1140. </ul>
  1141. <h4>Reference manual</h4>
  1142. <p>The <a
  1143. href="//www.webtoolkit.eu/wt/doc/reference/html/index.html"
  1144. target="_blank"> reference manual</a> has been generated from the
  1145. source code using doxygen.</p>
  1146. <h4>Annotated examples</h4>
  1147. <p>Source-level documentation has also been generated for the examples
  1148. and can be viewed <a href="//www.webtoolkit.eu/wt/doc/examples/html/modules.html"
  1149. target="_blank">here (in a new window)</a>.</p>
  1150. <h4>Wiki</h4>
  1151. <p>
  1152. There is a community-run <a href="http://redmine.webtoolkit.eu/projects/wt/wiki">Wt Wiki</a> with useful information such as a FAQ and
  1153. tips and tricks.
  1154. </p>
  1155. </message>
  1156. <message id="srcview.title.CPP.">
  1157. <div class="srcviewtitle">
  1158. <h2>Source code for Wt examples</h2>
  1159. <p>
  1160. Browse below the source code for all examples included in
  1161. <a href="#/">Wt</a>.
  1162. </p>
  1163. </div>
  1164. </message>
  1165. <message id="srcview.title.">Wt examples</message>
  1166. <message id="srcview.title.CPP.hello">
  1167. <div class="srcviewtitle">
  1168. <h2>Source code of the <i>Hello world</i> example</h2>
  1169. <p>
  1170. Browse below the source code for Wt's
  1171. <a href="#/examples/">Hello world</a> example.
  1172. </p>
  1173. </div>
  1174. </message>
  1175. <message id="srcview.title.hello">Example: Hello world</message>
  1176. <message id="srcview.title.CPP.hangman">
  1177. <div class="srcviewtitle">
  1178. <h2>Source code of the <i>Hangman</i> example</h2>
  1179. <p>
  1180. Browse below the source code for Wt's
  1181. <a href="#/examples/">Hangman</a> example.
  1182. </p>
  1183. </div>
  1184. </message>
  1185. <message id="srcview.title.hangman">Example: Hangman</message>
  1186. <message id="srcview.title.CPP.charts">
  1187. <div class="srcviewtitle">
  1188. <h2>Source code of the <i>Charts</i> example</h2>
  1189. <p>
  1190. Browse below the source code for Wt's
  1191. <a href="#/examples/charts">Charts</a> example.
  1192. </p>
  1193. </div>
  1194. </message>
  1195. <message id="srcview.title.charts">Example: Charts</message>
  1196. <message id="srcview.title.CPP.treeview-dragdrop">
  1197. <div class="srcviewtitle">
  1198. <h2>Source code of the <i>Treeview</i> example</h2>
  1199. <p>
  1200. Browse below the source code for Wt's <a href="#/examples/treeview">
  1201. Treeview</a> example.
  1202. </p>
  1203. </div>
  1204. </message>
  1205. <message id="srcview.title.treeview-dragdrop">Example: Treeview</message>
  1206. <message id="srcview.title.CPP.composer">
  1207. <div class="srcviewtitle">
  1208. <h2>Source code of the <i>Mail composer</i> example</h2>
  1209. <p>
  1210. Browse below the source code for Wt's
  1211. <a href="#/examples/composer">Mail composer</a> example.
  1212. </p>
  1213. </div>
  1214. </message>
  1215. <message id="srcview.title.composer">Example: Mail composer</message>
  1216. <message id="srcview.title.CPP.wt-homepage">
  1217. <div class="srcviewtitle">
  1218. <h2>Source code of the <i>Wt homepage</i> example</h2>
  1219. <p>
  1220. Browse below the source code for Wt's
  1221. <a href="#/examples/wt-homepage">Homepage</a> example.
  1222. </p>
  1223. </div>
  1224. </message>
  1225. <message id="srcview.title.wt-homepage">Example: Wt Homepage</message>
  1226. <message id="srcview.title.CPP.gitmodel">
  1227. <div class="srcviewtitle">
  1228. <h2>Source code of the <i>Git explorer</i> example</h2>
  1229. <p>
  1230. Browse below the source code for Wt's
  1231. <a href="#/examples/gitmodel">Git explorer</a> example.
  1232. </p>
  1233. </div>
  1234. </message>
  1235. <message id="srcview.title.gitmodel">Example: Git explorer</message>
  1236. <message id="srcview.title.CPP.simplechat">
  1237. <div class="srcviewtitle">
  1238. <h2>Source code of the <i>Chat</i> example</h2>
  1239. <p>
  1240. Browse below the source code for Wt's
  1241. <a href="#/examples/simplechat">Chat</a> example.
  1242. </p>
  1243. </div>
  1244. </message>
  1245. <message id="srcview.title.simplechat">Example: Chat</message>
  1246. <message id="srcview.title.CPP.widgetgallery">
  1247. <div class="srcviewtitle">
  1248. <h2>Source code of the <i>Widget gallery</i> example</h2>
  1249. <p>
  1250. Browse below the source code for Wt's
  1251. <a href="#/examples/widgetgallery">Widget gallery</a> example.
  1252. </p>
  1253. </div>
  1254. </message>
  1255. <message id="srcview.title.widgetgallery">Example: Widget gallery</message>
  1256. </messages>