Document Twitter access

_extensions/slack.py

@@ -1,11 +1,19 @@
+"""
+Sphinx extension which adds a new role :slack:, which allows you to easily
+make links to pyvec.slack.com Slack channels. Example::
+
+    In any doubt, ask in the :slack:`#pyvo` channel.
+"""
+
 from docutils import nodes
 
 
 # https://docutils.readthedocs.io/en/sphinx-docs/howto/rst-roles.html
 def slack(name, rawtext, text, lineno, inliner,
           options=None, content=None):
-    url = f"https://pyvec.slack.com/app_redirect?channel={text.lstrip('#')}"
-    node = nodes.reference(rawtext, text, refuri=url, **(options or {}))
+    text = text.lstrip('#')
+    url = f"https://pyvec.slack.com/app_redirect?channel={text}"
+    node = nodes.reference(rawtext, f'#{text}', refuri=url, **(options or {}))
     return [node], []
 
 

_extensions/twitter.py

@@ -0,0 +1,22 @@
+"""
+Sphinx extension which adds a new role :twitter:, which allows you to easily
+make links to twitter.com profiles. Example::
+
+    There's Twitter account :twitter:`napyvo`.
+"""
+
+from docutils import nodes
+
+
+# https://docutils.readthedocs.io/en/sphinx-docs/howto/rst-roles.html
+def twitter(name, rawtext, text, lineno, inliner,
+            options=None, content=None):
+    text = text.lstrip('@')
+    url = f"https://twitter.com/{text}"
+    node = nodes.reference(rawtext, f'@{text}', refuri=url, **(options or {}))
+    return [node], []
+
+
+def setup(app):
+    app.add_role('twitter', twitter)
+    return {'version': '1.0', 'parallel_read_safe': True}

conf.py

@@ -40,6 +40,7 @@
     'sphinx_tabs.tabs',
     'sphinxemoji.sphinxemoji',
     'slack',
+    'twitter',
 ]
 
 # Add any paths that contain templates here, relative to this directory.

guides/meetup.rst

@@ -193,8 +193,10 @@ Před každým setkáním v předstihu přidejte informace na `pyvo.cz <https://
 Propagace
 ^^^^^^^^^
 
+Existuje Twitter účet :twitter:`napyvo`, kam lze psát cokoliv v souvislosti s vaším srazem. :ref:`Zažádejte si o přístup <twitter>` a nebojte se tam psát. Nad toto ještě existuje robot `pyvo-twitter <https://github.com/pyvec/pyvo-twitter>`_, který píše na :twitter:`napyvo` automatické zprávy upozorňující na srazy. Upozorňuje ovšem jen na ty srazy, které jsou včas :ref:`potvrzené na pyvo.cz <srazy-pyvocz>`. Jestliže zaznamenáte nějaký problém s robotem, pište do :slack:`#automatizace`.
+
 .. warning::
-    Tato sekce ještě není připravena.
+    Tato sekce ještě není zcela připravena.
 
 ..
     Lanyrd, Facebook Event + Pyonieri, Srazy.info, univerzity, firmy, Twitter... zpravicka na root.cz, zpravicka na   zdrojak, email pozvanka na django-cs / py konference, meetup.com, https://wiki.python.org/moin/PythonEventsCalendar

guides/promotion.rst

@@ -148,6 +148,8 @@ Na Facebooku se vyplatí na rozdíl od Twitteru dávat věci i o víkendu, proto
 
 Emoji pomáhají tomu, aby si lidi statusu všimli, ale nemělo by se to s nimi asi úplně přehánět.
 
+.. _twitter-promotion:
+
 Twitter
 ~~~~~~~
 

operations/index.rst

@@ -13,6 +13,7 @@ kolem `programovacího jazyka Python <https://python.cz>`__. Její cíle jsou fo
    support-money
    runbooks
    domains
+   twitter
    meeting-notes
    grants
    bylaws

operations/twitter.rst

@@ -0,0 +1,117 @@
+.. _twitter:
+
+Twitter
+=======
+
+Aktuální stav Twitter účtů spravovaných českou Python komunitou.
+
+Přístupy
+--------
+
+Přístup k účtům se uděluje pomocí `TweetDeck Teams <https://help.twitter.com/en/using-twitter/tweetdeck-teams>`_, nesdílí se heslo. TweetDeck je nástroj přímo od Twitteru, skrze který lze přistupovat i k jiným účtům a spravovat týmy jednotlivých účtů. Takto přidělené přístupy by měly respektovat i mobilní aplikace. Pokud chcete do nějakého z účtů přístup, řekněte někomu, kdo má funkci Admin. Pokud stačí, aby někdo něco na vaši žádost tvítnul, požádejte kohokoliv, kdo má přístup.
+
+Jestliže organizujete nějaké `Pyvo <https://pyvo.cz/>`_, nebojte si říct o přístup k účtu :twitter:`napyvo` a psát na něj ohledně svého srazu!
+
+Účty
+----
+
+.. contents::
+   :depth: 1
+   :local:
+
+@napyvo
+^^^^^^^
+
++-------------+---------------------------------------------------------------------------------+
+| **Odkaz:**  | :twitter:`napyvo`                                                               |
++-------------+---------------------------------------------------------------------------------+
+| **Účel:**   | `Pyvo <https://pyvo.cz/>`_ srazy, ale i tak nějak centrální účet české komunity |
++-------------+---------------------------------------------------------------------------------+
+
+
+Admin
+   :twitter:`honzajavorek`, :twitter:`lumirbalhar`, :twitter:`hroncok`, :twitter:`EnCuKou`, :twitter:`kvbik`
+
+Contributor
+   :twitter:`janbednarik`, :twitter:`JirkaV`, :twitter:`MartinCurlej`, :twitter:`_apophys_`, :twitter:`krcmar`, :twitter:`tbedrich`, :twitter:`aleszoulek`, :twitter:`lurkingideas`, :twitter:`JiriPsotka`, :twitter:`stibi`
+
+@pyconcz
+^^^^^^^^
+
++-------------+---------------------------------------------------------------------------------+
+| **Odkaz:**  | :twitter:`pyconcz`                                                              |
++-------------+---------------------------------------------------------------------------------+
+| **Účel:**   | `PyCon CZ <https://cz.pycon.org/>`_, viz kapitola :ref:`twitter-promotion`      |
++-------------+---------------------------------------------------------------------------------+
+
+Admin
+   :twitter:`anezkamll`, :twitter:`BaraDrb`, :twitter:`honzajavorek`, :twitter:`lumirbalhar`, :twitter:`EnCuKou`
+
+Contributor
+   :twitter:`DariaGrudzien`
+
+@pyladiescz
+^^^^^^^^^^^
+
++-------------+---------------------------------------------------------------------------------+
+| **Odkaz:**  | :twitter:`pyladiescz`                                                           |
++-------------+---------------------------------------------------------------------------------+
+| **Účel:**   | `PyLadies CZ <https://pyladies.cz/>`_                                           |
++-------------+---------------------------------------------------------------------------------+
+
+Admin
+   Zuzejk nemá vlastní Twitter a chodí přímo přes heslo, dále :twitter:`anezkamll`, :twitter:`honzajavorek`, :twitter:`lumirbalhar`, :twitter:`EnCuKou`
+
+@pyvec
+^^^^^^
+
++-------------+---------------------------------------------------------------------------------+
+| **Odkaz:**  | :twitter:`pyvec`                                                                |
++-------------+---------------------------------------------------------------------------------+
+| **Účel:**   | `Pyvec <https://pyvec.org/>`_                                                   |
++-------------+---------------------------------------------------------------------------------+
+
+Admin
+   :twitter:`honzajavorek`, :twitter:`kvbik`
+
+@djangogirlsprg
+^^^^^^^^^^^^^^^
+
++-------------+---------------------------------------------------------------------------------+
+| **Odkaz:**  | :twitter:`djangogirlsprg`                                                       |
++-------------+---------------------------------------------------------------------------------+
+| **Účel:**   | `Django Girls <https://djangogirls.org/>`_ v Praze                              |
++-------------+---------------------------------------------------------------------------------+
+
+Admin
+   ???
+
+Contributor
+   :twitter:`honzajavorek`, ???
+
+@djangogirlsbrno
+^^^^^^^^^^^^^^^^
+
++-------------+---------------------------------------------------------------------------------+
+| **Odkaz:**  | :twitter:`djangogirlsbrno`                                                      |
++-------------+---------------------------------------------------------------------------------+
+| **Účel:**   | `Django Girls <https://djangogirls.org/>`_ v Brně                               |
++-------------+---------------------------------------------------------------------------------+
+
+Admin
+   :twitter:`honzajavorek`
+
+Contributor
+   :twitter:`KatiaNakamura`, :twitter:`ThatDocsLady`
+
+@pythoncz
+^^^^^^^^^
+
++-------------+---------------------------------------------------------------------------------+
+| **Odkaz:**  | :twitter:`pythoncz`                                                             |
++-------------+---------------------------------------------------------------------------------+
+| **Účel:**   | nepoužívá se, místo toho se uchytilo :twitter:`napyvo`                          |
++-------------+---------------------------------------------------------------------------------+
+
+Admin
+   :twitter:`honzajavorek`