From a40abfbb66f2bb99704f35d894326150ac10360d Mon Sep 17 00:00:00 2001 From: Mike Gabriel Date: Thu, 19 Apr 2018 23:05:23 +0200 Subject: README -> README.md (+ retain README as symlink) --- README | 52 +--------------------------------------------------- README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+), 51 deletions(-) mode change 100644 => 120000 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index 16ce040..0000000 --- a/README +++ /dev/null @@ -1,51 +0,0 @@ -# Ayatana System Indicator -- Session - -The -session Ayatana System Indicator is the the session menu indicator -for Unity7 and MATE (optionally for others). Its behavior and features -are listed at https://wiki.ayatana-indicators.org/AyatanaIndicatorSession - -For instructions on building and running built-in tests, see the INSTALL file. - - -## Notes for Client Renderers - -Ayatana Indicator Session has two custom menuitems: the Guest and User -switchers. As per the -https://wiki.ayatana-indicators.org/AyatanaIndicatorSession -specification, both need four visual components: (1) an Active Session -Mark, the user's (2) icon, (3) name, and (4) a Logged In Mark. - -### User menuitems have "x-canonical-type" set to "indicator.user-menu-item" - - Their four visual components are determined by: - - 1. You can test for the Action Session Mark by checking the action's state. - The state is a dicionary whose "active-user" key yields the current - session's owner's username. If it matches the username in this menuitem's - "target" attribute, show the Active Session Mark. - - 2. The icon is stored in the menuitem's "icon" attribute. If none is set, - the client should use a fallback icon such as "avatar-default." - - 3. The name is stored in the menuitem's "label" attribute. - - 4. You can test for the Logged In Mark by checking the action's state. - The state is a dictionary whose "logged-in-users" key will give - an array of usernames. If the array contains the username in this - menuitem's "target" attribute, show the Logged In Mark. - -### The Guest switcher has "x-canonical-type" set to "indicator.guest-menu-item" action - - Its four visual components are determined by: - - 1. You can test for the Active Session Mark by checking the action's state. - The state is a dictionary whose "is-active" key yields a boolean. - If the boolean is true, show the Active Session Mark. - - 2. The guest user should use a fallback icon such as "avatar-default." - - 3. The name ("Guest") is stored in the menuitem's "label" attribute. - - 4. You can test for the Logged In Mark by checking the action's state. - The state is a dictionary whose "is-logged-in" key yields a boolean. - If the boolean is true, show the Logged In Mark. diff --git a/README b/README new file mode 120000 index 0000000..42061c0 --- /dev/null +++ b/README @@ -0,0 +1 @@ +README.md \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..16ce040 --- /dev/null +++ b/README.md @@ -0,0 +1,51 @@ +# Ayatana System Indicator -- Session + +The -session Ayatana System Indicator is the the session menu indicator +for Unity7 and MATE (optionally for others). Its behavior and features +are listed at https://wiki.ayatana-indicators.org/AyatanaIndicatorSession + +For instructions on building and running built-in tests, see the INSTALL file. + + +## Notes for Client Renderers + +Ayatana Indicator Session has two custom menuitems: the Guest and User +switchers. As per the +https://wiki.ayatana-indicators.org/AyatanaIndicatorSession +specification, both need four visual components: (1) an Active Session +Mark, the user's (2) icon, (3) name, and (4) a Logged In Mark. + +### User menuitems have "x-canonical-type" set to "indicator.user-menu-item" + + Their four visual components are determined by: + + 1. You can test for the Action Session Mark by checking the action's state. + The state is a dicionary whose "active-user" key yields the current + session's owner's username. If it matches the username in this menuitem's + "target" attribute, show the Active Session Mark. + + 2. The icon is stored in the menuitem's "icon" attribute. If none is set, + the client should use a fallback icon such as "avatar-default." + + 3. The name is stored in the menuitem's "label" attribute. + + 4. You can test for the Logged In Mark by checking the action's state. + The state is a dictionary whose "logged-in-users" key will give + an array of usernames. If the array contains the username in this + menuitem's "target" attribute, show the Logged In Mark. + +### The Guest switcher has "x-canonical-type" set to "indicator.guest-menu-item" action + + Its four visual components are determined by: + + 1. You can test for the Active Session Mark by checking the action's state. + The state is a dictionary whose "is-active" key yields a boolean. + If the boolean is true, show the Active Session Mark. + + 2. The guest user should use a fallback icon such as "avatar-default." + + 3. The name ("Guest") is stored in the menuitem's "label" attribute. + + 4. You can test for the Logged In Mark by checking the action's state. + The state is a dictionary whose "is-logged-in" key yields a boolean. + If the boolean is true, show the Logged In Mark. -- cgit v1.2.3