Publicera artiklar till GitBook
Anslut GitBook med en personlig åtkomstnyckel och publicera Clevera-artiklar som sidor i dina GitBook-spaces. Var du skapar nyckeln, väljer webbplatser, hur tips, steg och flikar konverteras, vad uppdatering innebär och vanliga fel.
Publicera en Clevera-artikel som en sida i ett GitBook-space. GitBook ansluts med en personlig åtkomstnyckel istället för inloggning, och sidan visas på toppnivån i det space du väljer.
Innan du börjar
- I Clevera: arbetsytan har abonnemanget Pro eller Anpassad, och du är ägare eller administratör för att ansluta GitBook. När den väl är ansluten kan alla som kan redigera en artikel publicera den. Se Publicera artiklar till dina andra verktyg.
- I GitBook: valfritt abonnemang. Nyckeln agerar som den GitBook-användare som skapade den, så den personen behöver redigeringsåtkomst till de spaces du publicerar till.
- En artikel: generera den först. Publicering skickar endast artikeln. För att inkludera en video, placera den inuti artikeln; se Visa en video i en artikel.
Skapa en GitBook-åtkomstnyckel
- I GitBook, öppna dina kontoinställningar och gå till Developer (
app.gitbook.com/account/developer). - Skapa en ny personlig åtkomsttoken, ge den ett namn som "Clevera" och kopiera den. GitBook visar den bara en gång.
Anslut GitBook
Öppna anslutningsfönstret
I Clevera, klicka på ditt arbetsytans namn i sidofältet, välj Integrationer, hitta GitBook och klicka på Anslut. Fönstret Anslut GitBook säger "Klistra in en nyckel. Vi kontrollerar den innan vi sparar något." och har en Open GitBook-länk till Developer-sidan.
Klistra in och kontrollera nyckeln
Klistra in nyckeln i Åtkomstnyckel och klicka på Kontrollera nyckel. När GitBook accepterar den ser du "Nyckel accepterad."
Välj webbplatser
Under Webbplatser att publicera till listar Clevera dina dokumentwebbplatser (eller spaces) och markerar alla. Öppna listan för att avmarkera de du inte vill ha, till exempel "2 av 3 valda", och klicka sedan på Anslut. Du ser "GitBook ansluten.".
Clevera kontrollerar nyckeln innan den sparar något.
Om ditt GitBook-konto inte har några spaces alls, skapar Clevera ett med namnet "Clevera" i din första organisation så att du kan publicera direkt.
Nyckeln går inte ut på Cleveras sida. För att ändra nyckeln eller webbplatserna, öppna ⋯-menyn på GitBook-anslutningen, välj Återanslut och gå igenom samma fönster; den nya nyckeln och valet ersätter de gamla.
Publicera en artikel till GitBook
Öppna fliken Publicera
I redigeraren, klicka på Dela → Publicera och klicka på GitBook-rutan under Redo att publicera.
Välj ett space
Under Vart den går visar listan de spaces som finns bakom de webbplatser du valde, med deras ikoner.
Publicera
Klicka på Publicera till GitBook. Clevera letar först efter en befintlig kopia; om en sida med samma titel redan finns i det space du valt, välj vad du vill göra (se Uppdatera en sida du publicerat). När det är klart ser du "Publicerad till GitBook." Klicka på Öppna i GitBook för att se sidan.
Du kan stänga Dela-fönstret medan det körs; en avisering meddelar dig när det är klart.
Sidan läggs till på toppnivån i det space du valt, och dess adress kommer från titeln: "Set up billing" blir /set-up-billing. Titlar i andra alfabet eller med accenter stavas med latinska bokstäver först; en titel där inget finns kvar att stava får en kort fast kod. Flytta eller byt namn på sidan i GitBook efteråt om du vill.
Hur sidan ser ut i GitBook
Sidtiteln är artikelns titel. Sidan innehåller endast artikeln: videon som artikeln kom ifrån läggs inte till.
| I Clevera | I GitBook |
|---|---|
| Rubriker, stycken | Rubriker och text |
| Fetstil, kursiv, genomstrykning, inline-kod, länkar | Behålls |
| Markering, upphöjd text, nedsänkt text | Behålls |
| Punktlistor och numrerade listor, checklistor | Listor och att-göra-listor |
| Citat | Citat |
| Kodblock | Kodblock med språket och kodtiteln |
| Avdelare | Avdelare |
| Tabeller | Tabeller med texten i varje cell |
| Callouts | Hint-block: info → Info, note → Info, tip → Success, success → Success, warning → Warning, danger → Danger |
| Numrerade steg | En GitBook-stepper, ett steg per steg |
| Flikar | GitBook-flikar |
| Hopfällbara sektioner | Expanderbara block |
| Kort | En lista med länkar och deras beskrivningar; kortikoner utelämnas |
| Ekvationer | GitBook-matematik |
| Skärmdumpar | Bilder uppladdade till det space du valt, med bildtext |
| Videor och inbäddningar i artikeln | Inbäddningsblock. En Clevera-video inkluderas endast när videons delningslänk är på. |
Skärmdumpar laddas upp i det space du valt som filer, så de fortsätter fungera även om du tar bort artikeln i Clevera. En videofil som laddats upp i artikeln förblir en länk till Clevera som går ut efter en tid; publicera igen för att förnya den.
Uppdatera en sida du publicerat
Publicering går bara åt ett håll. GitBook-sidan uppdateras inte när du redigerar artikeln i Clevera, och ändringar som görs i GitBook kommer aldrig tillbaka till Clevera. När du har redigerat artikeln, publicera den igen till samma space. Clevera letar efter en sida med samma titel (skiftlägesoberoende) eller samma adress och visar "Denna artikel finns redan i GitBook."
- Uppdatera den befintliga artikeln skriver över sidans innehåll och titel. Adressen förblir densamma. Ändringar som gjorts i GitBook sedan dess skrivs över; GitBooks historik låter dig få tillbaka dem. Klicka på Uppdatera i GitBook.
- Skapa en ny artikel lägger till en andra sida under den Ny titel du anger (Clevera föreslår en som "Set up billing (2)"), med sin egen adress. Klicka på Skapa ny artikel.
Koppla från och återkalla åtkomst
- I Clevera, öppna Integrationer, klicka på GitBook, sedan Koppla från och bekräfta. Sidor du redan publicerat finns kvar i GitBook.
- I GitBook, ta bort åtkomstnyckeln på Developer-sidan så att den inte kan användas igen.
Felsökning
| Du ser | Vad du ska göra |
|---|---|
| "Klistra in en nyckel först." | Nyckelfältet är tomt. |
| "Ogiltig GitBook-åtkomstnyckel. Kontrollera och försök igen." | Nyckeln är felaktig eller har tagits bort. Skapa en ny och klistra in den. |
| "Det gick inte att validera GitBook-åtkomstnyckeln." eller "Vi kunde inte kontrollera den nyckeln. Försök igen." | GitBook svarade inte. Försök igen om en stund. |
| "Välj minst en webbplats." | Markera minst en webbplats före Anslut. |
| "Inga GitBook-spaces eller dokumentwebbplatser hittades, och vi kunde inte skapa en automatiskt. Skapa ett space i GitBook och försök igen." | Skapa ett space i GitBook, anslut sedan igen. |
| "Det gick inte att ansluta till GitBook. Kontrollera din åtkomstnyckel." | Kontrollera nyckeln och anslut igen. |
| "Det gick inte att läsa in dina GitBook-spaces. Försök igen." | Klicka på Försök igen. Om det upprepas, återanslut GitBook. |
| "Välj ett space att publicera till." | Välj ett space först. |
| Ett space saknas i listan | Det ingår inte i de webbplatser du valde, eller nyckelns användare kan inte se det. Återanslut och välj webbplatsen. |
| "GitBook avvisade sidinnehållet" eller "GitBook kunde inte slå ihop ändringsbegäran", med GitBooks orsak | Nyckelns användare kan inte redigera det space du valt, eller GitBook nekade ändringen. Kontrollera åtkomst i GitBook, klicka sedan på Försök igen. |
| "Åtkomstnyckel hittades inte. Återanslut GitBook." | Återanslut GitBook med en nyckel. |
| "Artikelinnehållet är tomt eller ogiltigt." | Artikeln har inget innehåll än. Öppna den, kontrollera den, publicera sedan. |
| "Sidan som skulle ersättas hittades inte i GitBook. Den kan ha flyttats eller tagits bort." | Välj Skapa ny artikel istället. |
| "Det gick inte att publicera till GitBook. Försök igen." eller "Det gick inte att uppdatera sidan i GitBook. Försök igen." | Klicka på Försök igen. Om det fortsätter misslyckas, återanslut med en ny nyckel. |