mystx.ext.github_readme_stats.top_langs
=======================================

.. py:module:: mystx.ext.github_readme_stats.top_langs

.. autoapi-nested-parse::

   GitHub 最常用语言（Top Languages）卡片指令。

   ``GitHubTopLangsDirective`` 使用 GitHub Readme Stats 服务生成语言占比卡片，
   支持 ``layout``、``theme`` 与 ``langs_count`` 等选项。



Classes
-------

.. autoapisummary::

   mystx.ext.github_readme_stats.top_langs.GitHubTopLangsDirective


Module Contents
---------------

.. py:class:: GitHubTopLangsDirective(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)

   Bases: :py:obj:`mystx.ext.github_readme_stats.base.BaseGitHubCardDirective`


   渲染 GitHub Top Languages 卡片。

   选项:

   - ``username`` （必填）：GitHub 用户名；
   - ``layout`` （可选）：布局样式，默认为 ``compact``；
   - ``theme`` （可选）：主题名称，默认为 ``default``；
   - ``langs_count`` （可选）：展示语言数量，默认为 ``6``。

   Example:

       .. code-block:: rst

           .. github-top-langs::
               :username: octocat
               :layout: compact
               :theme: dark
               :langs_count: 8


   .. py:attribute:: option_spec

      Mapping of option names to validator functions.



   .. py:method:: run()

      根据选项构建 Top Languages 卡片 URL 并返回 HTML 节点。

      Returns:
          list[nodes.Node]: 单元素列表，包含原始 HTML ``<img>`` 节点。