Beginnen Sie Ihre OSS -Aktivitäten mit einem vollständigen japanischen Tutorial
Dies ist ein japanisches Open -Source -Projekt, mit dem Anfänger teilnehmen können.
Folgen Sie dem Tutorial, um Ihren ersten Beitrag zu erleben!
Wir helfen Ihnen gerne bei Ihrer ersten Pull -Anfrage ✌️
Einführung
Dieses Projekt ist ein japanisches Tutorial, mit dem Sie lernen können, wie Sie Git/Github in der Praxis verwenden und wie man in Open Source zusammenarbeitet!
Für wen ist das?
- Anfänger, die praktische Wege lernen möchten, um Git/GitHub zu verwenden
- Menschen, die sich für Open Source interessieren, aber nicht wissen, wie sie beitragen sollen
- Oder Sie möchten Ihre Fähigkeiten verbessern und gleichzeitig durch weitere Beiträge zusammenarbeiten
Was ist der Zweck dieses Projekts?
- Erleben Sie die tatsächliche gemeinsame Entwicklung mit Github, was selbst schwer zu lernen ist.
- Jeder hat Vertrauen und lernen, wie man zu Open -Source -Projekten beiträgt
- Und Entwicklern, die Open -Source -Kultur mögen, verbinden
Was ist Open Source überhaupt?
Was ist Open Source?
Wenn ein Projekt Open Source ist, bedeutet dies, dass jeder es aus eigener Laune verwenden, lernen, modifizieren und Ihr Projekt für jeden Zweck verteilen kann.
In den meisten Fällen können Open -Source -Projekte an der Entwicklung teilnehmen!
Beiträge zu Open -Source -Projekten sind
Dies ist eine großartige Möglichkeit, Ihre Fähigkeiten durch Zusammenarbeit mit anderen Entwicklern zu verbessern.
Wenn Sie nicht an Open Source interessiert sind und sich fragen, ob Sie sich anstrengen müssen, müssen Sie sich anstrengen.
Siehe hier: Warum zu Open Source beitragen?
Wie man teilnimmt
Erleben wir sofort die Beiträge zu Open -Source -Projekten!
Was soll ich tun?
Als Teilnehmer an diesem Projekt werden wir unseren Beitragsdatei.json -Datei die folgenden Informationen hinzufügen!
"name": "あなたのハンドルネーム",
"github": "あなたのGitHubアカウントのURL",
"favoriteColor": "あなたの好きなカラーコード",
"favoriteEmoji": "あなたの好きな絵文字"
Die eingegebenen Informationen werden auf der Website als Emoji -Symbol angezeigt.
Jedes Mal, wenn die Anzahl der Mitwirkenden zunimmt, wird die Website lebhaft!
Emoji-Animation.mp4
Wir möchten die ersten Beiträge von JAs Website noch mehr leisten als jetzt!
Bitte versuchen Sie, Ihre Hände zu bewegen
- Wirklich bewegen Sie Ihre Hände
- aufstellen:
- Schritt 1: Geben Sie dieses Repository auf
- Schritt 2: Klon auf die lokale Maschine klonen
- Schritt 3: Erstellen Sie einen Arbeitszweig
- Schritt 4: Änderungen vornehmen
- Schritt 5: Verpfändet Ihre Änderungen
- Schritt 6: Drücken Sie die Änderungen
- Schritt 7: Erstellen Sie eine Pull -Anforderung (PR)
- Schritt 8: Bewertet auf Bewertungen und Feedback
- Beenden: ?
- Weitere Schritte
- Andere Beiträge
Wirklich bewegen Sie Ihre Hände
In 8 einfachen Schritten Open -Source -Mitwirkenden werden ?
- Wenn Sie Hilfe benötigen, fragen Sie bei Diskussionen!
- Wenn Sie Verbesserungen an diesem Projekt finden, teilen Sie uns dies bitte durch Probleme mit!
Egal wie klein, wir sind willkommen?
aufstellen:
- Wenn Sie kein GitHub -Konto haben, erstellen Sie bitte eine per Anmelden.
- Und wenn nötig, empfehlen wir Ihnen, zuerst ein Github Hello World -Tutorial für vollständige Anfänger durchzuführen.
- Wenn ein Zugriffstoken, das ein Kennwort ersetzt, nicht festgelegt wird, kann zum Zeitpunkt eines Klons ein Fehler auftreten.
- In diesem Fall siehe Konfigurieren von GitHub -Zugriffstoken.
Schritt 1: Geben Sie dieses Repository auf
- Fork dieses Repository, indem Sie auf die Schaltfläche "Fork" in der oberen rechten Ecke der Projektseite (diese Seite) auf GitHub klicken.

- Klicken Sie dann auf die Schaltfläche "Gabel erstellen".
- Alle Elemente wie "Repository -Namen", "Beschreibung" und "Nur die
main kopieren" sind in Ordnung, da sie sich im Originalformat befinden!

Tipp
Dadurch wird eine Kopie dieses Repositorys in Ihrem Github -Konto erstellt?
Schritt 2: Klon auf die lokale Maschine klonen
Sie können die Datei auch auf GitHub bearbeiten.
Kopieren Sie das Forked Repository in Ihre lokale Maschine, um ein allgemeineres Workflow -Erlebnis zu erhalten.
- Klicken Sie auf GitHub zur Seite "Gabeled Repository", klicken Sie auf die Schaltfläche "Code" für grüne "Code" und kopieren Sie die HTTPS -URL.
- Ihre URL sollte so aussehen:
https://github.com/<あなたのアカウント名>/first-contributions-ja.github.io.git

- Öffnen Sie ein Terminal und navigieren Sie zum Verzeichnis, in dem Sie das Repository klonen möchten.
- Wenn Sie beispielsweise das Klonziel auf dem Desktop angeben möchten, können Sie den folgenden Befehl verwenden:
- Verwenden Sie den folgenden Befehl, um das Forked Repository in Ihre lokale Maschine zu klonen:
git clone 先ほどコピーしたクローンURL
Tipp
Auf diese Weise kann das Repository in Ihre lokale Maschine kopiert und in der lokalen Umgebung arbeiten
Schritt 3: Erstellen Sie einen Arbeitszweig

- Erstellen Sie als nächstes eine neue Zweigstelle, um Ihre Arbeit von
main Ihres Projekts zu trennen.- Sie können den folgenden Befehl verwenden:
git switch -c <ブランチ名> - Zweignamen sind aussagekräftige Namen, die sich auf die Arbeit beziehen, die Sie tun möchten. Also sieht es so aus:
git switch -c add-yourname
- ?Notiz )
- Vergessen Sie nicht,
yourname durch Ihren Griff zu ersetzen - Bitte geben Sie den Zweignamen in alphanumerischen halben Breitennamen ohne Hiragana, Kanji oder weiße Räume ein.
- : Ogino Chihiro, Ogino Chihiro
- Beispiel:
git switch -c add-oginochihiro
Tipp
Dies macht Sie bereit, Änderungen vorzunehmen, ohne das main -Repository direkt zu beeinflussen?
Schritt 4: Änderungen vornehmen
- Öffnen Sie zunächst den geklonten Ordner in Ihrem bevorzugten Code -Editor wie VSCODE.
- Bevor Sie Änderungen vornehmen, stellen Sie sicher, dass Sie mit dem Zweig zusammenarbeiten, den Sie im vorherigen Schritt erstellt haben!
- Sie können den aktuellen Zweig mit dem folgenden Befehl überprüfen:
- Nehmen wir nun Änderungen an der Datei der Mitwirkenden.json vor.
- Kopieren und fügen Sie den folgenden Code in die "Ende der Liste" in Ihre Datei mit den Mitwirkenden.json ein:
,
{
"name": "あなたのハンドルネーム",
"github": "あなたのGitHubアカウントのURL",
"favoriteColor": "あなたの好きなカラーコード",
"favoriteEmoji": "あなたの好きな絵文字"
}

- Ersetzen Sie dann den Inhalt des eingefügten Textes durch Ihren eigenen Inhalt.
- ? Weitere Informationen finden Sie auf der folgenden Website: Liste der Emojis, Primary Color Dictionary, japanische traditionelle Farben
- Wenn Sie beispielsweise alles ersetzen, würde es so aussehen:
<!-- 変更後 -->
~~
},
{
"name": "oginochihiro",
"github": "https://github.com/first-contributions-ja",
"favoriteColor": "#ffffff",
"favoriteEmoji": "?"
}
]
Schritt 5: Änderungen begehen
- Kehren Sie zum Terminal zurück und verwenden Sie den folgenden Befehl, um die Änderungen am lokalen Repository zu begehen:
- Vergessen Sie nicht,
yourname durch Ihren Griffnamen zu ersetzen.
git add .
git commit -m "yournameをコントリビューターに追加"
Tipp
Dadurch werden alle Änderungen an protokolliert, die Sie an Ihrer Datei Ihrer Mitwirkenden.json vornehmen
Schritt 6: Drücken Sie die Änderungen
- Drücken Sie Änderungen in das Forked Remote Repository:
Tipp
Auf diese Weise können die von Ihnen erwähnten Commits (lokale Änderungen) in Ihrem Remote -Repository auf GitHub erwähnt?
Schritt 7: Erstellen Sie eine Pull -Anforderung (PR)
- Gehen Sie zur Seite "Forked Remote Repository" unter GitHub (
https://github.com/あなたのアカウント/first-contributions-ja.github.io ). - Klicken Sie oben auf die Schaltfläche "Vergleich & Pull -Anfrage".

- Klicken Sie nach der Bestätigung Folgendes auf die Schaltfläche "Pull -Anforderung erstellen".
- Um sicher zu sein, stellen Sie sicher, dass Sie von der
add-yourname Filiale Ihres Repositorys in main von First-Contributions-Js gehen! - Der Titel bleibt als erste Eingabe und die Beschreibung ist leer!

Tipp
Auf diese Weise werden in dem Repository, aus dem Sie Fork gaben, Änderungen, die Sie durch Gabering vorgenommen haben, angefordert werden?
Schritt 8: Reagieren Sie auf Bewertungen und Feedback
Ihre PR wird vom Projektbetrieb überprüft (bestätigt).
- Es ist ziemlich normal, dass Rezensenten Änderungen an der PR verlangen. In diesem Fall eine Korrektur vornehmen, da dies ein häufiges Ereignis ist.
- In diesem Fall kehren Sie einfach zu demselben Arbeitszweig wie zuvor zurück und stellen die angeforderten Änderungen vor, begehen und die Änderungen auf die gleiche Weise vorantreiben.
- PR wird automatisch mit einem neuen Druck aktualisiert.
Die meisten Bewertungen werden innerhalb von 24 Stunden vorgenommen, es kann jedoch zu Verzögerungen von mehreren Tagen kommen. Bitte warten Sie geduldig ☕
Beenden:?
- Sobald die Pull -Anfrage genehmigt wurde, werden alle von Ihnen vorgenommenen Änderungen in das Hauptprojekt zusammengefasst.
Vielen Dank für Ihre harte Arbeit!
Und vielen Dank für Ihre Zeit und Mühe, um zu ersten Beiträgen zu beitragen, Ja! !
Weitere Schritte
Wichtig
Wenn Sie dieses Projekt nützlich finden, drücken Sie die Sterntaste oben oben auf der Seite!
Teilen Sie auch mit Ihren Anhängern und Bekannten, um dieses Projekt zu verbreiten!
Sie haben gelernt, wie man zu Open -Source -Projekten beiträgt!
- Schauen Sie zurück auf die Arbeit, die Sie geleistet haben, und halten Sie Ihr Wissen an Ort und Stelle.
- Sie haben gerade den Standard -Workflow abgeschlossen, den Sie häufig als Mitwirkender erleben: Lesen Sie die Dokumentation → Gabel → Änderungen → Pull -Anfrage vornehmen !
- Erste Beiträge JA ist ein Open -Source -Projekt, sodass Sie auf andere Weise als das obige Tutorial beitragen können.
- Bitte teilen Sie uns mit, was Sie über dieses Projekt zu Diskussionen denken.
- Wenn Sie interessiert sind, lesen Sie andere Beiträge.
- Bitte tragen Sie auch zu anderen Open -Source -Projekten bei!
- Schauen Sie sich die Anfängerthemen auf GitHub (erste Kontributionen und gut-erste Ausgabe) an!
- Wenn Sie ein Repository haben, zu dem Sie beitragen möchten, suchen Sie nach Problemen mit der Bezeichnung " gutes erstes Problem ".
- Dies stellt im Allgemeinen ein Problem für Anfänger dar, die neu in bestimmten Projekten oder Open Source selbst sind!
Andere Beiträge
Wenn Sie weitere Beiträge leisten möchten, lesen Sie bitte die Beitragsrichtlinien!
Irgendwelche kleinen Beiträge wie das Hinzufügen von Code, das Fixieren von Fehler, die Verbesserung der Dokumentation sind willkommen?
Lizenz
Dieses Projekt ist unter MIT -Lizenz lizenziert.
Anerkennung
Dieses Projekt umfasst Erstkontributionen und beiträgt zu diesem Projekt bei.
Es wird von einem großartigen Open -Source -Projekt für Anfänger beeinflusst.