diff --git a/README.md b/README.md index ba882c5a2..a75c00839 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ A toolkit for building rich console apps for .NET, .NET Core, and Mono that works on Windows, the Mac, and Linux/Unix. -![Sample app](https://raw.githubusercontent.com/migueldeicaza/gui.cs/master/docfx/sample.gif) +![Sample app](https://raw.githubusercontent.com/migueldeicaza/gui.cs/master/docfx/images/sample.gif) ## Controls and Views diff --git a/docfx/_exported_templates/README.md b/docfx/_exported_templates/README.md new file mode 100644 index 000000000..a22678eba --- /dev/null +++ b/docfx/_exported_templates/README.md @@ -0,0 +1,11 @@ +Regenerate anytime with + +```powershell\ +docfx template export default +``` + +Technically, this can be deleted from the Terminal.Gui project, but it's left in place +for convenience. + +See https://dotnet.github.io/docfx/tutorial/howto_create_custom_template.html + diff --git a/docfx/articles/views.md b/docfx/articles/views.md index 3fb032df3..e00b33da8 100644 --- a/docfx/articles/views.md +++ b/docfx/articles/views.md @@ -1,31 +1,31 @@ *Terminal.Gui* provides a rich set of views and controls for building terminal user interfaces: -* [Button](~/api/Terminal.Gui/Terminal.Gui.Button.html) - A View that provides an item that invokes an System.Action when activated by the user. -* [CheckBox](~/api/Terminal.Gui/Terminal.Gui.CheckBox.html) - Shows an on/off toggle that the user can set. -* [ColorPicker](~/api/Terminal.Gui/Terminal.Gui.ColorPicker.html) - Enables to user to pick a color. -* [ComboBox](~/api/Terminal.Gui/Terminal.Gui.ComboBox.html) - Provides a drop-down list of items the user can select from. -* [Dialog](~/api/Terminal.Gui/Terminal.Gui.Dialog.html) - A pop-up Window that contains one or more Buttons. - * [OpenDialog](~/api/Terminal.Gui/Terminal.Gui.OpenDialog.html) - A Dialog providing an interactive pop-up Window for users to select files or directories. - * [SaveDialog](~/api/Terminal.Gui/Terminal.Gui.SaveDialog.html) - A Dialog providing an interactive pop-up Window for users to save files. -* [FrameView](~/api/Terminal.Gui/Terminal.Gui.FrameView.html) - A container View that draws a frame around its contents. Similar to a GroupBox in Windows. -* [GraphView](~/api/Terminal.Gui/Terminal.Gui.GraphView.html) - A View for rendering graphs (bar, scatter etc). -* [Hex viewer/editor](~/api/Terminal.Gui/Terminal.Gui.HexView.html) - A hex viewer and editor that operates over a file stream. -* [Label](~/api/Terminal.Gui/Terminal.Gui.Label.html) - Displays a string at a given position and supports multiple lines. -* [ListView](~/api/Terminal.Gui/Terminal.Gui.ListView.html) - Displays a scrollable list of data where each item can be activated to perform an action. -* [MenuBar](~/api/Terminal.Gui/Terminal.Gui.MenuBar.html) - Provides a menu bar with drop-down and cascading menus. -* [MessageBox](~/api/Terminal.Gui/Terminal.Gui.MessageBox.html) - Displays a modal (pup-up) message to the user, with a title, a message and a series of options that the user can choose from. -* [ProgressBar](~/api/Terminal.Gui/Terminal.Gui.ProgressBar.html) - Displays a progress Bar indicating progress of an activity. -* [RadioGroup](~/api/Terminal.Gui/Terminal.Gui.RadioGroup.html) - Displays a group of labels each with a selected indicator. Only one of those can be selected at a given time -* [ScrollView](~/api/Terminal.Gui/Terminal.Gui.ScrollView.html) - Present a window into a virtual space where subviews are added. Similar to the iOS UIScrollView. -* [ScrollBarView](~/api/Terminal.Gui/Terminal.Gui.ScrollBarView.html) - display a 1-character scrollbar, either horizontal or vertical. -* [StatusBar](~/api/Terminal.Gui/Terminal.Gui.StatusBar.html) - A View that snaps to the bottom of a Toplevel displaying set of status items. Includes support for global app keyboard shortcuts. -* [TableView](~/api/Terminal.Gui/Terminal.Gui.TableView.html) - A View for tabular data based on a System.Data.DataTable. -* [TimeField](~/api/Terminal.Gui/Terminal.Gui.TimeField.html) & [DateField](~/api/Terminal.Gui/Terminal.Gui.TimeField.html) - Enables structured editing of dates and times. -* [TextField](~/api/Terminal.Gui/Terminal.Gui.TextField.html) - Provides a single-line text entry. -* [TextValidateField](~/api/Terminal.Gui/Terminal.Gui.TextValidateField.html) - Text field that validates input through a ITextValidateProvider. -* [TextView](~/api/Terminal.Gui/Terminal.Gui.TextView.html)- A multi-line text editing View supporting word-wrap, auto-complete, context menus, undo/redo, and clipboard operations, -* [TopLevel](~/api/Terminal.Gui/Terminal.Gui.Toplevel.html) - The base class for modal/pop-up Windows. -* [TreeView](~/api/Terminal.Gui/Terminal.Gui.TreeView.html) - A hierarchical tree view with expandable branches. Branch objects are dynamically determined when expanded using a user defined ITreeBuilder. -* [View](!/api/Terminal.Gui/Terminal.Gui.View.html) - The base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views. -* [Window](~/api/Terminal.Gui/Terminal.Gui.Window.html) - A Toplevel view that draws a border around its Frame with a title at the top. -* [Wizard](~/api/Terminal.Gui/Terminal.Gui.Wizard.html) - Provides navigation and a user interface to collect related data across multiple steps. +* [Button](~/api/Terminal.Gui/Terminal.Gui.Button.yml) - A View that provides an item that invokes an System.Action when activated by the user. +* [CheckBox](~/api/Terminal.Gui/Terminal.Gui.CheckBox.yml) - Shows an on/off toggle that the user can set. +* [ColorPicker](~/api/Terminal.Gui/Terminal.Gui.ColorPicker.yml) - Enables to user to pick a color. +* [ComboBox](~/api/Terminal.Gui/Terminal.Gui.ComboBox.yml) - Provides a drop-down list of items the user can select from. +* [Dialog](~/api/Terminal.Gui/Terminal.Gui.Dialog.yml) - A pop-up Window that contains one or more Buttons. + * [OpenDialog](~/api/Terminal.Gui/Terminal.Gui.OpenDialog.yml) - A Dialog providing an interactive pop-up Window for users to select files or directories. + * [SaveDialog](~/api/Terminal.Gui/Terminal.Gui.SaveDialog.yml) - A Dialog providing an interactive pop-up Window for users to save files. +* [FrameView](~/api/Terminal.Gui/Terminal.Gui.FrameView.yml) - A container View that draws a frame around its contents. Similar to a GroupBox in Windows. +* [GraphView](~/api/Terminal.Gui/Terminal.Gui.GraphView.yml) - A View for rendering graphs (bar, scatter etc). +* [Hex viewer/editor](~/api/Terminal.Gui/Terminal.Gui.HexView.yml) - A hex viewer and editor that operates over a file stream. +* [Label](~/api/Terminal.Gui/Terminal.Gui.Label.yml) - Displays a string at a given position and supports multiple lines. +* [ListView](~/api/Terminal.Gui/Terminal.Gui.ListView.yml) - Displays a scrollable list of data where each item can be activated to perform an action. +* [MenuBar](~/api/Terminal.Gui/Terminal.Gui.MenuBar.yml) - Provides a menu bar with drop-down and cascading menus. +* [MessageBox](~/api/Terminal.Gui/Terminal.Gui.MessageBox.yml) - Displays a modal (pup-up) message to the user, with a title, a message and a series of options that the user can choose from. +* [ProgressBar](~/api/Terminal.Gui/Terminal.Gui.ProgressBar.yml) - Displays a progress Bar indicating progress of an activity. +* [RadioGroup](~/api/Terminal.Gui/Terminal.Gui.RadioGroup.yml) - Displays a group of labels each with a selected indicator. Only one of those can be selected at a given time +* [ScrollView](~/api/Terminal.Gui/Terminal.Gui.ScrollView.yml) - Present a window into a virtual space where subviews are added. Similar to the iOS UIScrollView. +* [ScrollBarView](~/api/Terminal.Gui/Terminal.Gui.ScrollBarView.yml) - display a 1-character scrollbar, either horizontal or vertical. +* [StatusBar](~/api/Terminal.Gui/Terminal.Gui.StatusBar.yml) - A View that snaps to the bottom of a Toplevel displaying set of status items. Includes support for global app keyboard shortcuts. +* [TableView](~/api/Terminal.Gui/Terminal.Gui.TableView.yml) - A View for tabular data based on a System.Data.DataTable. +* [TimeField](~/api/Terminal.Gui/Terminal.Gui.TimeField.yml) & [DateField](~/api/Terminal.Gui/Terminal.Gui.TimeField.yml) - Enables structured editing of dates and times. +* [TextField](~/api/Terminal.Gui/Terminal.Gui.TextField.yml) - Provides a single-line text entry. +* [TextValidateField](~/api/Terminal.Gui/Terminal.Gui.TextValidateField.yml) - Text field that validates input through a ITextValidateProvider. +* [TextView](~/api/Terminal.Gui/Terminal.Gui.TextView.yml)- A multi-line text editing View supporting word-wrap, auto-complete, context menus, undo/redo, and clipboard operations, +* [TopLevel](~/api/Terminal.Gui/Terminal.Gui.Toplevel.yml) - The base class for modal/pop-up Windows. +* [TreeView](~/api/Terminal.Gui/Terminal.Gui.TreeView.yml) - A hierarchical tree view with expandable branches. Branch objects are dynamically determined when expanded using a user defined ITreeBuilder. +* [View](~/api/Terminal.Gui/Terminal.Gui.View.yml) - The base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views. +* [Window](~/api/Terminal.Gui/Terminal.Gui.Window.yml) - A Toplevel view that draws a border around its Frame with a title at the top. +* [Wizard](~/api/Terminal.Gui/Terminal.Gui.Wizard.yml) - Provides navigation and a user interface to collect related data across multiple steps. diff --git a/docfx/build.ps1 b/docfx/build.ps1 index a6aa50467..3f69376a5 100644 --- a/docfx/build.ps1 +++ b/docfx/build.ps1 @@ -6,4 +6,4 @@ rm ../docs -Recurse -Force #docfx --metadata -docfx --metadata --serve \ No newline at end of file +docfx --serve --force \ No newline at end of file diff --git a/docfx/sample.gif b/docfx/images/sample.gif similarity index 100% rename from docfx/sample.gif rename to docfx/images/sample.gif diff --git a/docfx/sample.png b/docfx/images/sample.png similarity index 100% rename from docfx/sample.png rename to docfx/images/sample.png diff --git a/docfx/images/wizard.gif b/docfx/images/wizard.gif new file mode 100644 index 000000000..53eb279cf Binary files /dev/null and b/docfx/images/wizard.gif differ diff --git a/docfx/index.md b/docfx/index.md index e67aef1b8..775fb4d31 100644 --- a/docfx/index.md +++ b/docfx/index.md @@ -1,6 +1,8 @@ -# Terminal.Gui - Terminal UI toolkit for .NET +# Terminal.Gui - Cross Platform Terminal UI toolkit for .NET -A simple UI toolkit for .NET, .NET Core, and Mono that works on Windows, the Mac, and Linux/Unix. +A toolkit for building rich console apps for .NET, .NET Core, and Mono that works on Windows, the Mac, and Linux/Unix. + +![Sample](images/sample.gif) * [Terminal.Gui Project on GitHub](https://github.com/migueldeicaza/gui.cs) diff --git a/docfx/templates/default/styles/main.css b/docfx/templates/default/styles/main.css index ee13c51bc..0d28db9c8 100644 --- a/docfx/templates/default/styles/main.css +++ b/docfx/templates/default/styles/main.css @@ -114,6 +114,7 @@ article h4 { -webkit-box-shadow: var(--card-box-shadow); -moz-box-shadow: var(--card-box-shadow); box-shadow: var(--card-box-shadow); + font-family: 'Source Code Pro', 'Courier New', Courier, monospace } .subnav { diff --git a/docs/articles/views.html b/docs/articles/views.html index 8fc4ed7aa..8c9eee31f 100644 --- a/docs/articles/views.html +++ b/docs/articles/views.html @@ -102,7 +102,7 @@
  • TextView- A multi-line text editing View supporting word-wrap, auto-complete, context menus, undo/redo, and clipboard operations,
  • TopLevel - The base class for modal/pop-up Windows.
  • TreeView - A hierarchical tree view with expandable branches. Branch objects are dynamically determined when expanded using a user defined ITreeBuilder.
  • -
  • View - The base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views.
  • +
  • View - The base class for all views on the screen and represents a visible element that can render itself and contains zero or more nested views.
  • Window - A Toplevel view that draws a border around its Frame with a title at the top.
  • Wizard - Provides navigation and a user interface to collect related data across multiple steps.
  • diff --git a/docs/images/sample.gif b/docs/images/sample.gif new file mode 100644 index 000000000..93dabf105 Binary files /dev/null and b/docs/images/sample.gif differ diff --git a/docs/images/sample.png b/docs/images/sample.png new file mode 100644 index 000000000..27cfe5c81 Binary files /dev/null and b/docs/images/sample.png differ diff --git a/docs/images/wizard.gif b/docs/images/wizard.gif new file mode 100644 index 000000000..53eb279cf Binary files /dev/null and b/docs/images/wizard.gif differ diff --git a/docs/index.html b/docs/index.html index 5f2ef587d..f59285ef1 100644 --- a/docs/index.html +++ b/docs/index.html @@ -5,9 +5,9 @@ - Terminal.Gui - Terminal UI toolkit for .NET + Terminal.Gui - Cross Platform Terminal UI toolkit for .NET - + @@ -71,9 +71,10 @@
    -

    Terminal.Gui - Terminal UI toolkit for .NET

    +

    Terminal.Gui - Cross Platform Terminal UI toolkit for .NET

    -

    A simple UI toolkit for .NET, .NET Core, and Mono that works on Windows, the Mac, and Linux/Unix.

    +

    A toolkit for building rich console apps for .NET, .NET Core, and Mono that works on Windows, the Mac, and Linux/Unix.

    +

    Sample

    diff --git a/docs/index.json b/docs/index.json index 49c0423ff..49b604bfa 100644 --- a/docs/index.json +++ b/docs/index.json @@ -1301,8 +1301,8 @@ }, "index.html": { "href": "index.html", - "title": "Terminal.Gui - Terminal UI toolkit for .NET", - "keywords": "Terminal.Gui - Terminal UI toolkit for .NET A simple UI toolkit for .NET, .NET Core, and Mono that works on Windows, the Mac, and Linux/Unix. Terminal.Gui Project on GitHub Terminal.Gui API Documentation API Reference Views and controls built into the Terminal.Gui library Terminal.Gui API Overview Keyboard Event Processing Event Processing and the Application Main Loop TableView Deep Dive TreeView Deep Dive UI Catalog UI Catalog is a comprehensive sample library for Terminal.Gui. It provides a simple UI for adding to the catalog of scenarios. UI Catalog API Reference UI Catalog Source" + "title": "Terminal.Gui - Cross Platform Terminal UI toolkit for .NET", + "keywords": "Terminal.Gui - Cross Platform Terminal UI toolkit for .NET A toolkit for building rich console apps for .NET, .NET Core, and Mono that works on Windows, the Mac, and Linux/Unix. Terminal.Gui Project on GitHub Terminal.Gui API Documentation API Reference Views and controls built into the Terminal.Gui library Terminal.Gui API Overview Keyboard Event Processing Event Processing and the Application Main Loop TableView Deep Dive TreeView Deep Dive UI Catalog UI Catalog is a comprehensive sample library for Terminal.Gui. It provides a simple UI for adding to the catalog of scenarios. UI Catalog API Reference UI Catalog Source" }, "README.html": { "href": "README.html", diff --git a/docs/manifest.json b/docs/manifest.json index ed7721113..332a0b555 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -3157,15 +3157,12 @@ "version": "" }, { - "log_codes": [ - "InvalidFileLink" - ], "type": "Conceptual", "source_relative_path": "articles/views.md", "output": { ".html": { "relative_path": "articles/views.html", - "hash": "lGm0ADuULHQBWWb0zYAZO5MmIudgHUxDp8IvKHNnIjY=" + "hash": "g9sE7ikfpaAJU7igs3/Dk2ZYH3T/GKa/fDU4IYaw2yE=" } }, "is_incremental": false, @@ -3193,13 +3190,46 @@ "is_incremental": false, "version": "" }, + { + "type": "Resource", + "source_relative_path": "images/sample.gif", + "output": { + "resource": { + "relative_path": "images/sample.gif" + } + }, + "is_incremental": false, + "version": "" + }, + { + "type": "Resource", + "source_relative_path": "images/sample.png", + "output": { + "resource": { + "relative_path": "images/sample.png" + } + }, + "is_incremental": false, + "version": "" + }, + { + "type": "Resource", + "source_relative_path": "images/wizard.gif", + "output": { + "resource": { + "relative_path": "images/wizard.gif" + } + }, + "is_incremental": false, + "version": "" + }, { "type": "Conceptual", "source_relative_path": "index.md", "output": { ".html": { "relative_path": "index.html", - "hash": "nONipyTdueJl9Zb0V9z/8z0QQdE08fJbUVEBVToo/Po=" + "hash": "XWDyl25OXa1/jrN/f3ki6PzqMRjL/91oEdJfKGg7IR4=" } }, "is_incremental": false, @@ -3221,23 +3251,25 @@ "incremental_info": [ { "status": { - "can_incremental": true, + "can_incremental": false, + "details": "Disable incremental build by force rebuild option.", "incrementalPhase": "build", "total_file_count": 0, - "skipped_file_count": 0 + "skipped_file_count": 0, + "full_build_reason_code": "ForceRebuild" }, "processors": { "ConceptualDocumentProcessor": { - "can_incremental": true, + "can_incremental": false, "incrementalPhase": "build", "total_file_count": 9, - "skipped_file_count": 9 + "skipped_file_count": 0 }, "ManagedReferenceDocumentProcessor": { - "can_incremental": true, + "can_incremental": false, "incrementalPhase": "build", "total_file_count": 253, - "skipped_file_count": 253 + "skipped_file_count": 0 }, "ResourceDocumentProcessor": { "can_incremental": false, diff --git a/docs/styles/main.css b/docs/styles/main.css index ee13c51bc..0d28db9c8 100644 --- a/docs/styles/main.css +++ b/docs/styles/main.css @@ -114,6 +114,7 @@ article h4 { -webkit-box-shadow: var(--card-box-shadow); -moz-box-shadow: var(--card-box-shadow); box-shadow: var(--card-box-shadow); + font-family: 'Source Code Pro', 'Courier New', Courier, monospace } .subnav {