source-git-commit | workflow-type | source-wordcount | ht-degree |
---|---|---|---|
a6086afc0a1f099b62014ad61098a5a1dc9d4675 |
tm+mt |
719 |
3% |
Vi välkomnar bidrag från såväl communityn som från Adobe anställda utanför dokumentationsteamen.
Detta projekt har antagit Adobe Open Source Code of Conduct eller .NET Foundation Code of Conduct. Mer information finns i artikeln Contributing.
Se Adobe Docs Contributor Guide.
Hur du bidrar beror på vem du är och vilken typ av ändringar du vill bidra med:
Om du bidrar med mindre uppdateringar kan du besöka artikeln och klicka på feedbackområdet som visas längst ned i artikeln, klicka på Detaljerade feedbackalternativ och sedan på Föreslå en redigering för att gå till markeringskällfilen på GitHub. Använd GitHub-gränssnittet för att göra uppdateringar. Mer information finns i den allmänna handboken Adobe Docs Contributor.
Mindre korrigeringar och förtydliganden som du lämnar in för dokumentation och kodexempel i den här rapporten omfattas av Adobe användarvillkoren.
Om du är en del av Adobe-communityn och vill skapa en ny artikel eller skicka in större ändringar använder du fliken Problem i Git-databasen för att skicka in ett problem för att starta en konversation med dokumentationsteamet. När du har gått med på en plan måste du arbeta med en anställd för att få in det nya innehållet genom en kombination av arbete i det offentliga och privata arkivet.
Om du är teknikskribent, programchef eller utvecklare för en Adobe Experience Cloud-lösning och det är ditt jobb att bidra till eller skapa tekniska artiklar, bör du använda den privata databasen på https://git.corp.adobe.com/AdobeDocs
.
Deltagare i communityn kan använda GitHub-gränssnittet för grundläggande redigering eller förgrena rapporten för att göra större insatser.
Mer information finns i Adobe Docs Contributor Guide.
Alla artiklar i den här databasen använder smaksatt GitHub-kod. Om du inte är van vid att markera något läser du:
För vissa ämnen använder vi datafiler och mallar för att generera publicerat innehåll. Användningsexempel för den här metoden är:
- Publicera stora mängder programmatiskt genererat innehåll
- En enda källa till sanning för kunder i flera system som kräver maskinläsbara filformat, som YAML, för integrering (t.ex. Site-Wide Analysis Tool)
Exempel på mallat innehåll är, men är inte begränsade till, följande:
I allmänhet behöver de flesta skribenter bara lägga till en releaseversion till tabellerna med produkttillgänglighet och systemkrav. Underhåll för allt annat mallat innehåll automatiseras eller hanteras av en dedikerad teammedlem. De här instruktionerna är avsedda för de flesta skribenter.
OBS!
- För att generera mallinnehåll måste du arbeta på kommandoraden i en terminal.
- Du måste ha installerat Ruby för att köra återgivningsskriptet. Se _jekyll/.ruby-version för den version som krävs.
Här nedan finns en beskrivning av filstrukturen för mallat innehåll:
_jekyll
- Innehåller teman och obligatoriska resurser_jekyll/_data
- Innehåller de maskinläsbara filformat som används för att återge mallar_jekyll/templated
- Innehåller HTML-baserade mallfiler som använder mallspråket Flytandehelp/_includes/templated
- Innehåller genererade utdata för mallat innehåll i.md
-filformat så att det kan publiceras i Experience League-ämnen. Återgivningsskriptet skriver automatiskt genererade utdata till den här katalogen åt dig
Så här uppdaterar du mallinnehåll:
-
Öppna en datafil i katalogen
/jekyll/_data
i textredigeraren. Exempel:- Produkttillgänglighetstabeller:
/jekyll/_data/product-availability.yml
- Systemkravstabeller:
/jekyll/_data/system-requirements.yml
- Produkttillgänglighetstabeller:
-
Använd den befintliga YAML-strukturen för att skapa poster.
Om du till exempel vill lägga till en version av Adobe Commerce i produkttillgänglighetstabellerna lägger du till följande i varje post i
extensions
- ochservices
-avsnitten i/jekyll/_data/product-availability.yml
-filen (ändra versionsnummer efter behov):support: - core: 1.2.3 version: 4.5.6
-
Navigera till katalogen
_jekyll
.cd _jekyll
-
Generera mallinnehåll och skriv utdata till katalogen
help/_includes/templated
.rake render
OBS! Du måste köra skriptet från katalogen
_jekyll
. Om detta är första gången du kör skriptet måste du installera Ruby-beroenden först med kommandotbundle install
. -
Gå tillbaka till katalogen
root
.cd ..
-
Verifiera att de förväntade
help/_includes/templated
filerna har ändrats.git status
Utdata bör se ut ungefär så här:
modified: _data/product-availability.yml modified: help/_includes/templated/product-availability-extensions.md
-
Gör ändringar.
git add . git commit -m "descriptive message of the intended commit" git push
Mer information om datafiler, flytande filter och andra funktioner finns i dokumentationen för Jekyll.