diff --git a/docs/explanations/img/menu-bar.png b/docs/explanations/img/menu-bar.png new file mode 100644 index 0000000..d8bc19c Binary files /dev/null and b/docs/explanations/img/menu-bar.png differ diff --git a/docs/explanations/integrations.md b/docs/explanations/integrations.md new file mode 100644 index 0000000..a6921eb --- /dev/null +++ b/docs/explanations/integrations.md @@ -0,0 +1,12 @@ +# Integrations + +Kele is well-integrated with the Emacs ecosystem. + +## Menu Bar + +Kele is integrated with the Emacs [menu bar]. The **Kubernetes** section lets +you achieve many of the tasks that you'd normally use keybindings for. + +![](./img/menu-bar.png) + +[menu bar]: https://www.gnu.org/software/emacs/manual/html_node/emacs/Menu-Bar.html diff --git a/docs/img/menu-bar.png b/docs/img/menu-bar.png new file mode 100644 index 0000000..d8bc19c Binary files /dev/null and b/docs/img/menu-bar.png differ diff --git a/docs/index.md b/docs/index.md index cad0e2a..0cd717f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -20,6 +20,7 @@ With Kele, you can: resource](./how-tos/usage.md#working-with-resources); - [List collections of resources](./how-tos/usage.md#working-with-resources); - Start and stop [proxy servers](./how-tos/usage.md#managing-proxy-servers); +- Use the menu bar to perform basic cluster/config management; - And more! :sunglasses: See [How-Tos > Usage](./how-tos/usage.md) for more details on what's possible @@ -27,7 +28,7 @@ with Kele. !!! warning - Kele is in **very** early stages of development. As of 2023/01/26, it is + Kele is in **very** early stages of development. As of 2024/04/11, it is usable (I use it everyday for my day job!) but there are rough edges. Do give things a try and I'd appreciate [issues for any bugs or rough @@ -39,6 +40,7 @@ with Kele. -- @jinnovation ![](./img/demo.gif) +![](./img/menu-bar.png) !!! tip diff --git a/docs/references/changelog.md b/docs/references/changelog.md index 5467919..9cbbf95 100644 --- a/docs/references/changelog.md +++ b/docs/references/changelog.md @@ -11,6 +11,11 @@ versioning][semver]. ## Unreleased +### Added + +- [Menu bar] integration. Now you can access common tasks via the **Kubernetes** + section on the menu bar + ## 0.4.2 ### Fixed @@ -236,3 +241,4 @@ future enhancements. [How-Tos > Customization]:https://jonathanj.in/kele.el/how-tos/customization/ [How-Tos > Usage]: https://jonathanj.in/kele.el/how-tos/usage/ [Transient]: https://magit.vc/manual/transient.html +[Menu bar]: https://www.gnu.org/software/emacs/manual/html_node/emacs/Menu-Bar.html diff --git a/kele.el b/kele.el index d29b534..f6bf869 100644 --- a/kele.el +++ b/kele.el @@ -1718,6 +1718,18 @@ The `scope' is the current context name." (format-time-string "%F %T" kele--discovery-last-refresh-time))))) (string-join msgs "\n"))) +(easy-menu-define kele-menu-map kele-mode-map + "Menu for Kubernetes management. + +Similar to `kele-dispatch'." + '("Kubernetes" + ("Configuration" + ;; TODO: Make this a menu where user can select from the available contexts + ["Switch context" kele-context-switch] + ["Switch namespace for current context" kele-namespace-switch-for-current-context] + "---" + ["Find config file" kele-find-kubeconfig]))) + (provide 'kele) ;;; kele.el ends here