diff --git a/README.md b/README.md index 8638ebc..87321d0 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,9 @@ Gowut (Go Web UI Toolkit) is a full-featured, easy to use, platform independent Web UI Toolkit written in pure Go, no platform dependent native code is linked or called. -Development takes place in the `dev` branch: https://github.com/icza/gowut/tree/dev +For documentation please visit the [**Gowut Wiki**](https://github.com/icza/gowut/wiki). -For News, documentation and examples please visit the **Gowut Home Page** here: - -**https://sites.google.com/site/gowebuitoolkit/** +Development takes place in the [`dev` branch](https://github.com/icza/gowut/tree/dev). ## Quick install ## @@ -18,13 +16,17 @@ To quickly install (or update to) the **latest** version, type: ## Quick test ## -To quickly test it and see it in action, run the following example applications (assuming you're in the root of your `GOPATH`): +To quickly test it and see it in action, run the following example applications. + +Let's assume you're in the root of the Gowut project: + + cd $GOPATH/src/github.com/icza/gowut **1. Showcase of Features.** This one auto-opens itself in your default browser. - go run src/github.com/icza/gowut/_examples/showcase/showcase.go + go run _examples/showcase/showcase.go The Showcase of Features is also available live: https://gowut-demo.appspot.com/show @@ -32,13 +34,20 @@ The Showcase of Features is also available live: https://gowut-demo.appspot.com/ This one auto-opens itself in your default browser. - go run src/github.com/icza/gowut/_examples/simple/simple_demo.go + go run _examples/simple/simple_demo.go + +And this is how it looks: + +[![Full App Screenshot](https://github.com/icza/gowut/raw/dev/_images/full_app_example.png)](https://github.com/icza/gowut/wiki/Full-App-Example) **3. Login window example with session management.** - go run src/github.com/icza/gowut/_examples/login/login_demo.go +Change directory so that the demo can read the test cert and key files: + + cd _examples/login + go run login_demo.go -Open the page https://localhost:3434/guitest/ in your browser to see it. +Open the page `https://localhost:3434/guitest/` in your browser to see it. ## Godoc of Gowut ## diff --git a/_examples/showcase/showcasecore/showcasecore.go b/_examples/showcase/showcasecore/showcasecore.go index 4d9e278..1473c71 100644 --- a/_examples/showcase/showcasecore/showcasecore.go +++ b/_examples/showcase/showcasecore/showcasecore.go @@ -568,8 +568,8 @@ func buildLinkDemo(event gwu.Event) gwu.Comp { p := gwu.NewPanel() p.SetCellPadding(3) - p.Add(gwu.NewLink("Visit Gowut Home page", "https://sites.google.com/site/gowebuitoolkit/")) - p.Add(gwu.NewLink("Visit Gowut Project page", "https://github.com/icza/gowut")) + p.Add(gwu.NewLink("Visit the Gowut Wiki", "https://github.com/icza/gowut/wiki")) + p.Add(gwu.NewLink("Visit the Gowut Project page", "https://github.com/icza/gowut")) row := gwu.NewHorizontalPanel() row.SetCellPadding(3) @@ -580,7 +580,11 @@ func buildLinkDemo(event gwu.Event) gwu.Comp { row = gwu.NewHorizontalPanel() row.SetCellPadding(3) row.Add(gwu.NewLabel("Send e-mail to the Gowut author:")) - email := "iczaaa" + "@" + "gmail.com" + emailBytes := []byte("jd{bbbAhnbjm/dpn") + for i, v := range emailBytes { + emailBytes[i] = v - 1 + } + email := string(emailBytes) row.Add(gwu.NewLink("András Belicza <"+email+">", "mailto:"+email)) p.Add(row) @@ -832,11 +836,11 @@ func buildShowcaseWin(sess gwu.Session) { footer.Style().SetFullWidth().SetBorderTop2(2, gwu.BrdStyleSolid, "#cccccc") footer.Add(hiddenPan) footer.AddHConsumer() - l = gwu.NewLabel("Copyright © 2013-2016 András Belicza. All rights reserved.") + l = gwu.NewLabel("Copyright © 2013-2017 András Belicza. All rights reserved.") l.Style().SetFontStyle(gwu.FontStyleItalic).SetFontSize("95%") footer.Add(l) footer.AddHSpace(10) - link := gwu.NewLink("Visit Gowut Home page", "https://sites.google.com/site/gowebuitoolkit/") + link := gwu.NewLink("Visit the Gowut Wiki", "https://github.com/icza/gowut/wiki") link.Style().SetFontStyle(gwu.FontStyleItalic).SetFontSize("95%") footer.Add(link) setNoWrap(footer) diff --git a/_images/full_app_example.png b/_images/full_app_example.png new file mode 100644 index 0000000..b668b05 Binary files /dev/null and b/_images/full_app_example.png differ diff --git a/gwu/comp_addons.go b/gwu/comp_addons.go index cbee9c8..5264f85 100644 --- a/gwu/comp_addons.go +++ b/gwu/comp_addons.go @@ -230,7 +230,7 @@ type cellFmtImpl struct { hasHVAlignImpl // Has horizontal and vertical alignment implementation styleImpl *styleImpl // Style builder. Lazily initialized. - attrs map[string]string // Explicitly set HTML attributes for the cell. Lazily initalized. + attrs map[string]string // Explicitly set HTML attributes for the cell. Lazily initialized. } // newCellFmtImpl creates a new cellFmtImpl. diff --git a/gwu/doc.go b/gwu/doc.go index 00b3098..4c45932 100644 --- a/gwu/doc.go +++ b/gwu/doc.go @@ -18,8 +18,7 @@ Package gwu implements an easy to use, platform independent Web UI Toolkit in pure Go. -For additional documentation, News and more please visit the home page: -https://sites.google.com/site/gowebuitoolkit/ +For documentation please visit the Gowut Wiki: https://github.com/icza/gowut/wiki Introduction @@ -66,9 +65,9 @@ change (during event handling) without having to reload the whole page to see the changes. To quickly test it and see it in action, run the "Showcase of Features" -application by typing: (assuming you're in the root of your GOPATH) +application by typing: - go run src/github.com/icza/gowut/_examples/showcase/showcase.go + go run $GOPATH/src/github.com/icza/gowut/_examples/showcase/showcase.go Features of Gowut @@ -135,6 +134,7 @@ windows. When such a window is requested and no private session associated with the client exists, a new session will be created. A registered SessionHandler can be used then to create the window prior to it being served. Here's an example how to do it: + // A SessionHandler implementation: type sessHandler struct {} func (h sessHandler) Created(s gwu.Session) { @@ -154,7 +154,7 @@ from localhost), security is only guaranteed if you configure the server to run in secure (HTTPS) mode. -Under the hood +Under the Hood User interfaces are generated HTML documents which communicate with the server with AJAX calls. The GUI server is based on the web server integrated in Go. @@ -206,7 +206,7 @@ definitions of the built-in style classes. For example you can define the Buttons will have red background without having to change their style individually. -Component palette +Component Palette Containers to group and lay out components: Expander - shows and hides a content comp when clicking on the header comp @@ -234,7 +234,7 @@ Other components: Timer -Full application example +Full App Example Let a full example follow here which is a complete application. It builds a simple window, adds components to it, registers event handlers which @@ -382,7 +382,7 @@ Author: András Belicza Author email: gmail.com, user name: iczaaa -Home page: https://sites.google.com/site/gowebuitoolkit/ +Gowut Wiki: https://github.com/icza/gowut/wiki Source code: https://github.com/icza/gowut @@ -396,7 +396,7 @@ package gwu // Gowut version information. const ( - GowutVersion = "v1.2.0" // Gowut version: "v"major.minor.maintenance[-dev] + GowutVersion = "v1.2.1" // Gowut version: "v"major.minor.maintenance[-dev] GowutReleaseDate = "2017-01-16 CET" // Gowut release date GowutRelDateLayout = "2006-01-02 MST" // Gowut release date layout (for time.Parse()) ) diff --git a/version-history/changes-v1.1.1.txt b/version-history/changes-v1.1.1.txt index 00d6641..23f5cee 100644 --- a/version-history/changes-v1.1.1.txt +++ b/version-history/changes-v1.1.1.txt @@ -1,11 +1,11 @@ Changes and new features in v1.1.1: ----------------------------------- +----------------------------------- -Improvement: HTTP request and response writers are now exposed with Events. See issue #19. Not directly, but they are available after a type assertion. See HasRequestResponse type. --Fix: when something was selected in a ListBox, it was impossible to deselect everything from the UI. See issue #20. +-Fix: when something was selected in a ListBox, it was impossible to deselect everything from the UI. See issue #20. -Fix: open web page with xdg-open in linux diff --git a/version-history/changes-v1.1.2.txt b/version-history/changes-v1.1.2.txt index 7089b82..05c1204 100644 --- a/version-history/changes-v1.1.2.txt +++ b/version-history/changes-v1.1.2.txt @@ -1,6 +1,6 @@ Changes and new features in v1.1.2: ----------------------------------- +----------------------------------- -Many code optimization, code formatting and grammar fixing to have an A+ Go Report Card rating! https://goreportcard.com/report/github.com/icza/gowut diff --git a/version-history/changes-v1.2.0.txt b/version-history/changes-v1.2.0.txt index 124475c..c47f240 100644 --- a/version-history/changes-v1.2.0.txt +++ b/version-history/changes-v1.2.0.txt @@ -1,6 +1,6 @@ Changes and new features in v1.2.0: ----------------------------------- +----------------------------------- -BREAKING CHANGES! Renamed several interfaces and methods to conform to Go naming conventions. Gometalinter now gives 0 warnings. diff --git a/version-history/changes-v1.2.1.txt b/version-history/changes-v1.2.1.txt new file mode 100644 index 0000000..2cd0e16 --- /dev/null +++ b/version-history/changes-v1.2.1.txt @@ -0,0 +1,10 @@ + +Changes and new features in v1.2.1: +----------------------------------- + +-Replaced home page with the Gowut Wiki: +https://github.com/icza/gowut/wiki + +-Changed copyright year. + +-Other minor changes and improvements.