Skip to content

Latest commit

 

History

History
142 lines (90 loc) · 7.08 KB

README.md

File metadata and controls

142 lines (90 loc) · 7.08 KB
Raw
source-git-commit workflow-type source-wordcount ht-degree
a6086afc0a1f099b62014ad61098a5a1dc9d4675
tm+mt
719
3%

Adobe Commerce tekniska dokumentation

Vi välkomnar bidrag från såväl communityn som från Adobe anställda utanför dokumentationsteamen.

Adobe Öppna Source uppförandekod

Detta projekt har antagit Adobe Open Source Code of Conduct eller .NET Foundation Code of Conduct. Mer information finns i artikeln Contributing.

Om dina bidrag till Adobe innehåll

Se Adobe Docs Contributor Guide.

Hur du bidrar beror på vem du är och vilken typ av ändringar du vill bidra med:

Mindre ändringar

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.

Större ändringar eller nya artiklar från communitymedlemmar

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.

Stora förändringar för anställda i Adobe

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.

Verktyg och inställningar

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.

Så här använder du kod för att formatera ämnet

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:

Mallar

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:

Generera mallat innehåll

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 Flytande
  • help/_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:

  1. Öppna en datafil i katalogen /jekyll/_data i textredigeraren. Exempel:

  2. 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- och services-avsnitten i /jekyll/_data/product-availability.yml-filen (ändra versionsnummer efter behov):

    support:
   - core: 1.2.3
     version: 4.5.6

  3. Navigera till katalogen _jekyll.

    cd _jekyll

  4. 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 kommandot bundle install.

  5. Gå tillbaka till katalogen root.

    cd ..

  6. 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

  7. 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.