Git-opslagplaats lokaal instellen voor documentatie
In dit artikel worden de stappen beschreven voor het instellen van een git-opslagplaats op uw lokale computer, met de bedoeling om bij te dragen aan de documentatie van Adobe. Medewerkers kunnen een lokaal gekloonde opslagplaats gebruiken om nieuwe artikelen toe te voegen, bestaande artikelen ingrijpend te bewerken of illustraties te wijzigen.
Overzicht
Om aan de documentatie van Adobe bij te dragen, kunt u de aangewezen bewaarplaats in uw eigen rekening forkGitHub zodat u lees/schrijf toestemmingen hebt. Vervolgens kunt u Markdown-bestanden lokaal maken en bewerken door de corresponderende documentatieopslagplaats te klonen. Vervolgens gebruikt u pull-aanvragen om wijzigingen samen te voegen (te verzenden) in de alleen-lezen centrale gedeelde opslagplaats.
- Bepaal de juiste opslagplaats
- Maak de gegevensopslagplaats aan uw rekening van GitHub
- Een lokale map voor de gekloonde bestanden kiezen
- De opslagplaats klonen naar uw lokale computer
- De externe upstream-waarde configureren
De opslagplaats bepalen
U vork de aangewezen bewaarplaats in uw eigen rekening GitHub zodat u gelezen/schrijftoestemmingen daar hebt om uw voorgestelde veranderingen op te slaan. Adobe Experience Cloud documentatie bevindt zich in verschillende opslagplaatsen op github.com.
- Als u niet zeker weet welke repository u moet gebruiken, gaat u naar het artikel met uw webbrowser. Selecteer Bewerken koppeling (potloodpictogram) rechtsboven in het artikel. (Als u geen Edit verbinding ziet, is die inhoud nog niet beschikbaar in GitHub.)
Als u een bijdrage wilt leveren aan de Adobe-documentatie, kunt u Markeringen lokaal maken en bewerken door de corresponderende documentatieopslagplaats te klonen. Vervolgens gebruikt u trekkingsverzoeken om wijzigingen samen te voegen in de alleen-lezen centrale gedeelde opslagplaats.
Fork the repository
Gebruikend de aangewezen bewaarplaats, creeer een vork van de bewaarplaats in uw eigen rekening GitHub door de website te gebruiken GitHub.
Een persoonlijke vork is vereist omdat alle hoofddocumentatieruimten alleen-lezen toegang bieden, wat betekent dat u geen wijzigingen rechtstreeks kunt aanbrengen in de inhoud in de opslagruimten. Als u wijzigingen wilt aanbrengen, moet u een pull-aanvraag (PR) van uw vork indienen in de hoofdopslagplaats. Om dit proces te vergemakkelijken, hebt u eerst uw eigen exemplaar van de bewaarplaats nodig, waarin u schrijftoegang hebt. Een GitHub vork daartoe dient.
-
Ga naar de GitHub-pagina van de hoofdopslagplaats en klik op de knop Vork rechtsboven.
-
Als u wordt veroorzaakt, selecteer uw GitHub rekeningstegel als bestemming waar de vork zou moeten worden gecreeerd. Deze herinnering leidt tot een exemplaar van de bewaarplaats binnen uw rekening GitHub, die als vork wordt bekend.
-
Kies een mapnaam die u gemakkelijk kunt onthouden en typen.
Sommige opslagruimten kunnen groot zijn. Kies een locatie met beschikbare schijfruimte.
note note NOTE Kies geen lokaal mappad dat is genest in een andere locatie in de map van de it-opslagplaats. Hoewel het acceptabel is om de gekloonde mappen aan elkaar te koppelen, leidt het nesten van git-mappen in elkaar tot fouten bij het bijhouden van het bestand.
Een lokale kloon maken van de opslagplaats
Door een kloon van de geforceerde opslagplaats te maken, downloadt u een kopie van de bestanden naar uw computer. Als u klaar bent, kunt u bewerkingen van uw lokale station naar de geforceerde opslagplaats op de server uitvoeren. Vervolgens kunt u een pull-verzoek indienen om de bewerkingen upstream samen te voegen met de hoofdopslagplaats.
Deze stappen veronderstellen u de Desktop GitHub gebruikt. Als u een andere client gebruikt, brengt u de gewenste aanpassingen aan.
-
Klikken Klonen of downloaden en kies vervolgens Openen op bureaublad om een kopie van de opslagplaats (uw vork) naar de computer over te brengen in de huidige directory.
-
De Desktop van GitHub van het gebruik om de lokale dossiers in synchronisatie met de forked bewaarplaats te houden.
Zie voor meer informatie GitHub Desktop-documentatie.