Apie README failų kūrimo priemonė — Išsamus vadovas
README failų kūrimo priemonė yra interaktyvus vaizdinis generatorius, skirtas profesionaliai atvirojo kodo projektų dokumentacijai (`README.md`) struktūruoti. Jame pateikiamos modulinės skiltys projekto pavadinimams, šūkiams, Shields.io ženkliukams, pagrindinėms funkcijoms, diegimo vadovams ir licencijavimui.
Sinchronizuotas padalinto ekrano redaktorius sujungia neapdorotą Markdown kodą su tiesiogine atvaizdavimo peržiūra. Įjunkite arba išjunkite skyrius, keiskite jų tvarką ir eksportuokite išbaigtą Markdown dokumentaciją tiesiai į savo saugyklą.
Pagrindinės funkcijos ir galimybės
- Modulinių skilčių kūrimas: funkcijos, diegimas, naudojimas, konfigūracija ir bendradarbiavimas (contributing)
- Iš anksto sukonfigūruoti Shields.io ženkliukų pasirinkimai kūrimo būsenai, versijoms, licencijoms ir žvaigždutėms
- Sinchronizuotas padalinto ekrano redaktorius, teikiantis realaus laiko WYSIWYG Markdown atvaizdavimą
- Eksportavimas vienu spustelėjimu, generuojantis švarų GFM kodą su tiesioginiu `.md` failo atsisiuntimu
Kaip naudoti
- 1
Užpildykite pagrindinius projekto metaduomenis: pavadinimą, šūkį, saugyklos URL ir demonstracinę ekrano kopiją.
- 2
Pasirinkite atitinkamus technologijų steko ženkliukus ir sukonfigūruokite diegimo / paleidimo terminalo komandas.
- 3
Peržiūrėkite suformuotą dokumentacijos peržiūrą ir spustelėkite „Atsisiųsti README.md“.
Dažniausi naudojimo atvejai
- → Naujai paleistų atvirojo kodo saugyklų reprezentatyvumo didinimas su profesionaliu apipavidalinimu
- → Naujų darbuotojų įvedimo ir programavimo dokumentacijos standartizavimas įmonių inžinierių komandose
- → CLI kūrėjų įrankių dokumentavimas su aiškiomis diegimo instrukcijomis ir sintaksės pavyzdžiais
Susiję įrankiai
HTML meta žymų ir SEO generatorius
Generuokite teisingas HTML meta žymas, Open Graph ir Twitter Cards socialiniams tinklams ir paieškai.
Gitignore failų generatorius
Generuokite išsamius .gitignore failus pagal operacinę sistemą, kalbą ir kūrimo įrankį.
Atvirojo kodo licencijų generatorius
Pasirinkite ir generuokite MIT, Apache 2.0, GPL, BSD ir kitas atvirojo kodo licencijas savo projektui.
Conventional Commits formavimo priemonė
Formatuokite standartizuotus Git commit pranešimus pagal Conventional Commits standartą.
Semver versijų skaičiuotuvas
Apskaičiuokite kitą semantinę versiją (major, minor, patch) ir patikrinkite atitiktį rėžiams.
OpenAPI / Swagger peržiūros priemonė
Peržiūrėkite ir testuokite OpenAPI 3.0 ir Swagger 2.0 API specifikacijas interaktyvioje sąsajoje.
Dažniausiai užduodami klausimai ir privatumas
Ar Shields.io ženkliukai automatiškai atsinaujina GitHub platformoje?
Taip. Nurodžius savo GitHub naudotojo vardą ir saugyklos pavadinimą, Shields.io tiesiogiai kreipiasi į GitHub API, kad realiuoju laiku rodytų žvaigždutes, šakas (forks) ir išleidimo versijas.
Ar sugeneruotas Markdown yra suderinamas su GitLab ir Bitbucket?
Taip. Žymėjimas atitinka standartines CommonMark ir GFM gaires, užtikrinančias nepriekaištingą atvaizdavimą GitHub, GitLab ir Bitbucket platformose.