Commencez vos activités OSS avec un tutoriel japonais complet
Il s'agit d'un projet japonais open source conçu pour permettre aux débutants de participer facilement.
Suivez le tutoriel pour vivre votre première contribution!
Nous sommes heureux de vous aider avec votre première demande de traction ✌️
Introduction
Ce projet est un tutoriel japonais pour vous aider à apprendre à utiliser Git / Github dans la pratique et à collaborer en open source!
À qui est-ce?
- Débutants qui veulent apprendre des moyens pratiques d'utiliser Git / Github
- Les gens qui sont intéressés par l'open source mais qui ne savent pas comment contribuer
- Ou, vous voulez améliorer vos compétences tout en profitant de la collaboration grâce à plus de contributions
Quel est le but de ce projet?
- Découvrez un développement conjoint réel en utilisant GitHub, qui est difficile à apprendre par vous-même.
- Tout le monde a confiance et apprendre à contribuer à des projets open source
- Et aider les développeurs qui aiment la culture open source se connectent
Qu'est-ce que l'open source en premier lieu?
Qu'est-ce que l'open source?
Lorsqu'un projet est open source, cela signifie que quiconque peut l'utiliser à son propre caprice, apprendre, le modifier et distribuer votre projet à quelque fin que ce soit.
Dans la plupart des cas, les projets open source sont libres de participer au développement!
Les contributions aux projets open source sont
C'est un excellent moyen d'améliorer vos compétences grâce à la collaboration avec d'autres développeurs.
Si vous n'êtes pas intéressé par l'open source et que vous vous demandez si vous avez besoin de y faire des efforts,
Voir ici: Pourquoi contribuer à l'open source?
Comment participer
Voyons immédiatement les contributions aux projets open source!
Que dois-je faire?
En tant que participant à ce projet, nous ajouterons les informations suivantes à notre fichier contributeurs.json!
"name": "あなたのハンドルネーム",
"github": "あなたのGitHubアカウントのURL",
"favoriteColor": "あなたの好きなカラーコード",
"favoriteEmoji": "あなたの好きな絵文字"
Les informations saisies seront affichées sur le site Web en tant qu'icône emoji.
Ainsi, chaque fois que le nombre de contributeurs augmente, le site devient vivant!
emoji-animation.mp4
Nous voulons faire des premières contributions sur le site Web de JA encore plus pop que maintenant!
Veuillez essayer de bouger vos mains
- Déplacez vos mains réelles
- installation:
- Étape 1: fourchez ce référentiel
- Étape 2: Clone à la machine locale
- Étape 3: Créez une branche de travail
- Étape 4: apporter des modifications
- Étape 5: Commissez vos modifications
- Étape 6: poussez les modifications
- Étape 7: Créez une demande de traction (PR)
- Étape 8: Répondez aux avis et aux commentaires
- Finition: ?
- Plus d'étapes
- Autres contributions
Déplacez vos mains réelles
Devenir un contributeur open source en 8 étapes simples ?
- Si vous avez besoin d'aide, demandez aux discussions!
- Si vous trouvez des améliorations à ce projet, veuillez nous en informer grâce aux problèmes!
Peu importe à quel point nous sommes les bienvenus?
installation:
- Si vous n'avez pas de compte GitHub, veuillez en créer un via l'inscription.
- Et si nécessaire, nous vous recommandons de faire un tutoriel mondial GitHub Hello pour les débutants complets en premier.
- Si un jeton d'accès qui remplace un mot de passe n'est pas défini, une erreur peut se produire au moment d'un clone.
- Dans ce cas, voir Configuration des jetons d'accès GitHub.
Étape 1: fourchez ce référentiel
- Fourk ce référentiel en cliquant sur le bouton "Fork" dans le coin supérieur droit de la page du projet (cette page) sur GitHub.

- Cliquez ensuite sur le bouton "Créer une fourche".
- Tous les éléments tels que "nom du référentiel", "description" et "Copier uniquement la branche
main " sont OK comme ils sont dans le format d'origine!

Conseil
Cela créera une copie de ce référentiel dans votre compte GitHub?
Étape 2: Clone à la machine locale
Vous pouvez également modifier le fichier sur github,
Copiez le référentiel fourchu sur votre machine locale pour une expérience de workflow plus générale.
- Sur GitHub, accédez à la page du référentiel fourchu, cliquez sur le bouton vert "Code" et copiez l'URL HTTPS.
- Votre URL devrait ressembler à ceci:
https://github.com/<あなたのアカウント名>/first-contributions-ja.github.io.git

- Ouvrez un terminal et accédez au répertoire où vous souhaitez cloner le référentiel.
- Par exemple, si vous souhaitez spécifier la destination de clone sur le bureau, vous pouvez utiliser la commande suivante:
- Utilisez la commande suivante pour cloner le référentiel fourchu sur votre machine locale:
git clone 先ほどコピーしたクローンURL
Conseil
Cela permet au référentiel d'être copié sur votre machine locale et de travailler dans l'environnement local
Étape 3: Créez une branche de travail

- Ensuite, créez une nouvelle branche pour séparer votre travail de
main de votre projet.- Vous pouvez utiliser la commande suivante:
git switch -c <ブランチ名> - Les noms de branche sont des noms significatifs liés au travail que vous êtes sur le point de faire. Donc ça ressemble à ceci:
git switch -c add-yourname
- ?Note )
- N'oubliez pas de remplacer
yourname par votre poignée - Veuillez saisir le nom de la branche en caractères alphanumériques à demi-largeur sans espaces Hiragana, Kanji ou blancs.
- : Ogino Chihiro, Ogino Chihiro
- exemple:
git switch -c add-oginochihiro
Conseil
Cela vous rend prêt à apporter des modifications sans affecter directement le référentiel de projet main ?
Étape 4: apporter des modifications
- Pour commencer, ouvrez le dossier cloné dans votre éditeur de code préféré, comme VScode.
- Avant d'apporter des modifications, assurez-vous de travailler avec la branche que vous avez créée à l'étape précédente!
- Vous pouvez vérifier la branche actuelle avec la commande suivante:
- Faisons maintenant des modifications dans le fichier contributeurs.json.
- Copiez et collez le code suivant dans la "fin de liste" dans votre fichier contributeurs.json:
,
{
"name": "あなたのハンドルネーム",
"github": "あなたのGitHubアカウントのURL",
"favoriteColor": "あなたの好きなカラーコード",
"favoriteEmoji": "あなたの好きな絵文字"
}

- Remplacez ensuite le contenu du texte collé par votre propre contenu.
- ? Veuillez vous référer au site Web suivant: Liste des emojis, dictionnaire en couleur primaire, couleurs traditionnelles japonaises
- Par exemple, si vous remplacez tout, cela ressemblerait à ceci:
<!-- 変更後 -->
~~
},
{
"name": "oginochihiro",
"github": "https://github.com/first-contributions-ja",
"favoriteColor": "#ffffff",
"favoriteEmoji": "?"
}
]
Étape 5: commettre des modifications
- Retournez au terminal et utilisez la commande suivante pour commettre les modifications dans le référentiel local:
- N'oubliez pas de remplacer
yourname par votre nom de poignée.
git add .
git commit -m "yournameをコントリビューターに追加"
Conseil
Cela enregistrera toutes les modifications que vous apportez à votre fichier contributeur.json
Étape 6: poussez les modifications
- Poussez les modifications au référentiel distant fourchu:
Conseil
Cela permettra les commits que vous avez mentionnés plus tôt (modifications locales) dans votre référentiel distant sur GitHub?
Étape 7: Créez une demande de traction (PR)
- Accédez à la page de référentiel distant fourchu sur github (
https://github.com/あなたのアカウント/first-contributions-ja.github.io ). - Cliquez sur le bouton "Comparez et tirez la demande" en haut.

- Ensuite, après avoir confirmé ce qui suit, cliquez sur le bouton "Créer la demande de pull".
- Juste pour être en sécurité, assurez-vous que vous vous dirigez de la branche
add-yourname de votre référentiel à main de la première contribution-js! - Le titre reste comme entrée initiale et la description est vide!

Conseil
Cela demandera que les modifications que vous avez apportées par la fourniture se reflètent dans le référentiel à partir duquel vous fourchez?
Étape 8: Répondre aux avis et commentaires
Votre RP sera examiné (confirmé) par le responsable du projet.
- Il est assez normal pour les critiques de demander des modifications apportées au RP. Si cela se produit, faites une correction car c'est un événement courant.
- Dans ce cas, vous revenez simplement à la même branche de travail qu'auparavant et effectuez les modifications demandées, vous engagez et poussez les changements de la même manière.
- PR sera automatiquement mis à jour avec une nouvelle poussée.
La plupart des avis seront effectués dans les 24 heures, mais il peut y avoir des retards de plusieurs jours. Veuillez attendre patiemment ☕
Finition:?
- Une fois la demande de traction approuvée, toutes les modifications que vous apportez seront fusionnées dans le projet principal.
Merci pour votre travail acharné!
Et merci pour votre temps et vos efforts pour contribuer aux premières contributions JA! !
Plus d'étapes
Important
Si vous trouvez ce projet utile, appuyez sur le bouton étoile en haut de la page!
Partagez également avec vos abonnés et connaissances pour diffuser ce projet!
Vous avez appris à contribuer à des projets open source!
- Regardez le travail que vous avez fait et gardez vos connaissances en place.
- Vous venez de terminer le flux de travail standard que vous ressentez souvent en tant que contributeur: Lisez la documentation → Fork → apporter des modifications → Pull Demande !
- First Contributions JA est un projet open source, vous pouvez donc contribuer d'une manière différente de celle du tutoriel ci-dessus.
- Veuillez nous dire ce que vous pensez de ce projet sur les discussions?
- Si vous êtes intéressé, consultez d'autres contributions.
- Veuillez également contribuer à d'autres projets open source!
- Découvrez les sujets débutants sur GitHub (premières contributions et bons premiers problèmes)!
- Si vous avez un référentiel auquel vous souhaitez contribuer, recherchez des problèmes étiquetés " bon premier problème ".
- Cela représente généralement un problème pour les débutants qui sont nouveaux dans des projets spécifiques ou open source lui-même!
Autres contributions
Si vous souhaitez apporter plus de contributions, veuillez vous référer aux directives de contribution!
Toutes les petites contributions telles que l'ajout de code, la correction des bogues, l'amélioration de la documentation sont les bienvenues?
licence
Ce projet est autorisé sous licence MIT.
Remerciements
Ce projet comprend les premières contributions et contribue à ce projet.
Il est influencé par un excellent projet open source conçu pour les débutants.