All Contributors

All Contributors

  • Dokumentacja
  • GitHub
  • Languages iconPolski
    • English
    • 日本語
    • Deutsch
    • Español
    • Français
    • Bahasa Indonesia
    • 한국어
    • Português (Brasil)
    • Русский
    • 中文

›@bot All Contributors 🤖

Specyfikacja

  • Przegląd
  • Specyfikacja
  • Znacznik Emoji ✨
  • Repository Maintainers
  • Tooling

@bot All Contributors 🤖

  • Przegląd
  • Instalacja
  • Korzystanie
  • Konfiguracja
  • FAQs

CLI

  • Przegląd
  • Instalacja
  • Korzystanie
  • Konfiguracja

Projekt

  • Help us Improve
  • Kodeks Postępowania
  • Kto tego używa?
Edit

Konfiguracja Bota

Konfigurację bota all-contributors możesz przeprowadzić poprzez aktualizację pliku JSON .all-contributorsrc. Przechowywane tam będą dane użyte do stworzenia listy kontrybutorów oraz twoja konfiguracja według której @all-contributors wygeneruje listę.

Przeglądasz 🤖Konfigurację Bota, która podobna jest do Konfiguracji CLI

Klucze do określenia:

OpcjaOpisPrzykład/Domyślnie
plikiTablica plików do aktualizacji.Domyślnie: ['README.md']
rozmiar obrazuWymiary avatara użytkownika (w pikselach).Domyślnie: 100
contributorsPerLineMaksymalna liczba kolumn w tabeli kontrybutorów.Domyślnie: 7
contributorsSortAlphabeticallytrue: Sortuj alfabetycznie. false: Wyświetlaj w kolejności dodania.Domyślnie: false
badgeTemplateZdefiniuj szablon lodasha do wygenerowania odznaki.
contributorTemplateZdefiniuj szablon lodasha do wygenerowania kontrybutora.
typesOkreśl niestandardowe symbole lub podlinkuj szablony dla typów kontrybucji. Możesz nadpisać udokumentowane typy.
skipCiSprawia, że CI ignoruje zatwierdzenie. (either true or false)Domyślnie: true
contributorsLista Contributors do tego projektu została zaktualizowana poprzez komendę @all-contributors add
{
  "files": ["README.md"],
  "imageSize": 100,
  "contributorsPerLine": 7,
  "contributorsSortAlphabetically": false,
  "badgeTemplate": "[![All Contributors](https://img.shields.io/badge/all_contributors-<%= contributors.length %>-orange.svg?style=flat-square)](#contributors)",
  "contributorTemplate": "<a href=\"<%= contributor.profile %>\"><img src=\"<%= contributor.avatar_url %>\" width=\"<%= options.imageSize %>px;\" alt=\"\"/><br /><sub><b><%= contributor.name %></b></sub></a>",
  "types": {
    "custom": {
      "symbol": "🔭",
      "description": "A custom contribution type.",
      "link": "[<%= symbol %>](<%= url %> \"<%= description %>\"),"
    }
  },
  "skipCi": "true",
  "contributors": []
}

Moving the All Contributors table into a different file

As you know, the default file for the contributors table is README.md. But if your project has tons of contributors, it doesn't make sense to include the All Contributors table in the README.md file. Instead, you can use a different file to do so.

Here are the steps that may help you in achieving that. For the sake of this tutorial, the different file that we'll use is going to be named CONTRIBUTORS.md.

  1. Install the bot. See the Installation page for instructions.

  2. Add your first contributor. See the Bot Usage page for instructions.

  3. Create the CONTRIBUTORS.md file.

  4. Copy the code from the Contributors section in the README.md file, starting at the ALL-CONTRIBUTORS-LIST:START line, and ending at the ALL-CONTRIBUTORS-LIST:END line.

    Example:

    <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
    <!-- prettier-ignore-start -->
    <!-- markdownlint-disable -->
    <table>
    <tr>
      <td align="center">...</td>
    </tr>
    </table>
    <!-- markdownlint-restore -->
    <!-- prettier-ignore-end -->
    <!-- ALL-CONTRIBUTORS-LIST:END -->
    
  5. Modify the files key in the .all-contributorsrc JSON file to match your new file name.

    {
    "files": [
      "CONTRIBUTORS.md"
    ],
    ...
    }
    
  6. Now you should be good to go. New contributors will be added to this new file instead of the README.md file.

← KorzystanieFAQs →
All Contributors