Artikelen schrijven en collecties organiseren

Shayan TaslimBijgewerkt:

In je Helpcentrum staan artikelen in collecties. Je team beschikt over een uitgebreide tekstopmaakeditor met interne links, revisiegeschiedenis en instellingen voor zichtbaarheid.

Collecties organiseren

Open Helpcentrum → Artikelen in de zijbalk van het dashboard om je navigatiestructuur te beheren.

  • Maak een collectie aan. Klik op Nieuwe collectie in de bovenbalk, voer een Naam in (maximaal 255 tekens; UserJot stelt automatisch een pictogram voor terwijl je typt, totdat je er handmatig een kiest), kies een Pictogram en klik op Aanmaken. Nieuwe collecties verschijnen onderaan het hoogste niveau.

  • Een collectie bewerken. Klik met de rechtermuisknop op een collectie en selecteer Bewerken… om het pictogram, de naam of de Beschrijving (maximaal 500 tekens) aan te passen.

  • Nesten en de volgorde wijzigen. Sleep collecties en artikelen in de structuur om de volgorde te wijzigen of ze te nesten. Je kunt ook met de rechtermuisknop klikken en Verplaatsen naar kiezen. Collecties kunnen tot drie niveaus diep worden genest.

  • Hoogste niveau en niet-geplaatste artikelen. Artikelen op het Hoogste niveau staan buiten collecties en kunnen een aangepast pictogram hebben (klik met de rechtermuisknop → Pictogram wijzigen…). Als je in de bovenste balk op Nieuw artikel klikt, wordt er een niet-geplaatst concept gemaakt onder Geen collectie. Niet-geplaatste artikelen worden pas weergegeven of doorzoekbaar nadat je ze op het Hoogste niveau of in een collectie hebt geplaatst.

  • Een collectie verwijderen. Klik met de rechtermuisknop op een collectie en selecteer Verwijderen…. Collecties worden definitief verwijderd, zonder tussenstap via de prullenbak. Bevat de collectie artikelen, kies dan een andere collectie, het Hoogste niveau of Geen collectie als bestemming via De artikelen verplaatsen naar. Als je ze naar een andere collectie verplaatst, verwijzen de oude URL's van de verwijderde collectie daarnaartoe.

Schrijven met de editor

Elk artikel heeft een verplichte Titel (maximaal 255 tekens), een optionele Beschrijving (maximaal 500 tekens; gebruikt op kaarten en als metabeschrijving) en een inhoudseditor.

Druk op / op een nieuwe regel om blokken in te voegen:

  • Tekst, Kop (H2) en Subkop (H3). Voor koppen worden automatisch vaste sectie-ankers gegenereerd.

  • Opsomming, Genummerde lijst, Citaat, Codeblok (met taalselector) en Scheidingslijn.

  • Afbeelding (upload bestanden vanaf je computer; klik op een afbeelding om Alternatieve tekst of een Bijschrift toe te voegen, elk maximaal 500 tekens).

  • Tabel (begint als een tabel van 3 x 3 met een kopregel en zwevende bedieningselementen voor rijen en kolommen).

  • Uitlichtingsblokken voor Notitie, Tip en Waarschuwing, plus inklapbare Accordeon-blokken (titels van 1 tot 200 tekens). In de dashboardeditor kunnen uitlichtingsblokken en accordeons niet in elkaar worden genest (via de API of HTML-import kan een uitlichtingsblok in een accordeon staan, maar een uitlichtingsblok in een uitlichtingsblok, een accordeon in een uitlichtingsblok en een accordeon in een accordeon worden geweigerd).

  • Video-insluitingen van YouTube, Loom of Vimeo (of plak een losse link van een van deze aanbieders op een eigen regel).

Selecteer tekst om Vet, Cursief, Doorhalen, Code, Toets (opmaak voor sneltoetsen) of koppelingen toe te passen. Code en Toets kunnen niet worden gecombineerd met andere inline-opmaakmarkeringen, en tekst met Toets kan geen < of > bevatten. Documenten ondersteunen maximaal 1 MB JSON, 512 KB Markdown, 5.000 knooppunten en 32 niveaus van bloknesting.

Concepten worden automatisch opgeslagen terwijl je typt. Druk op ⌘S / Ctrl+S om handmatig op te slaan, druk op ⌘⇧\ / Ctrl+Shift+\ om de lijstbalk met artikelen in of uit te schakelen, schakel Voorbeeld rechtsonder in om de lezersweergave te bekijken, of klik linksonder op Typgeluid om optionele mechanische toetsgeluiden te kiezen (Alpaca, Cream, Mint, Mochi, Frost of Uit) en het volume in te stellen.

Markdown-dialect van het Help Center

De REST API, MCP-server, Pagina kopiëren en .md-eindpunten gebruiken GitHub-flavored Markdown, uitgebreid met:

  • <Note>, <Tip> en <Warning>-uitlichtingsblokken

  • <Accordion title="..."> inklapbare secties

  • {#custom-id} aan het einde van een kop om een vaste ankerlink in te stellen

  • <kbd>...</kbd> voor inline-toetsenbordtoetsen

  • Interne links geschreven als /articles/<slug> of /collections/<slug> (met optionele #heading)

Klik op de koppelingsknop in de selectiewerkbalk om Koppeling toevoegen te openen. Zoek in je Help Center naar artikelen, collecties en koppen van gepubliceerde artikelen (zoeken op koppen vereist minimaal 2 tekens en geeft maximaal 8 resultaten), of plak een externe https://-URL. Als je een URL naar een van je eigen Help Center-artikelen plakt, wordt deze omgezet in een interne verwijzing die blijft werken, zelfs als de slug van het doelartikel verandert.

Als een gekoppeld doel later wordt gedepubliceerd, naar de prullenbak wordt verplaatst of wordt verwijderd, markeert de editor die link inline zodat je deze kunt herstellen. In de lijst Gekoppeld vanuit in het rechterpaneel Artikel staan maximaal acht gepubliceerde artikelen die naar het huidige artikel linken.

Open het rechterpaneel Artikel om in te stellen hoe lezers een artikel kunnen vinden:

Instelling

Wat het doet

Zichtbaarheid

Kies Openbaar (wordt vermeld, is doorzoekbaar en wordt opgenomen in llms.txt en Juno), Niet-vermeld (alleen bereikbaar via een directe link; verborgen in navigatie, zoekresultaten en Juno) of Team (alleen voor aangemelde interne beheerders en eigenaren).

Collectie

Plaats het artikel op het Hoogste niveau, in een collectie of laat het staan onder Geen collectie.

Link

Klik op /help/articles/<slug> om Link wijzigen te openen (kleine letters, cijfers en streepjes; maximaal 60 tekens). Voor de eerste publicatie volgt de slug de titel, totdat je deze handmatig wijzigt. Na publicatie wordt bij een slugwijziging automatisch een omleiding vanaf de oude URL gemaakt.

Weergeven in zoekmachines

Sta indexering van dit artikel door zoekmachines toe of blokkeer deze. Indexering vereist ook dat het artikel openbaar is, een plek heeft en dat je Help Center is ingesteld op Live.

Zoekwoorden

Voeg verborgen zoekwoorden toe voor de huidige taal (maximaal 50 zoekwoorden van elk 64 tekens). Druk op Enter of een komma om een zoekwoord toe te voegen.

Je kunt ook een Auteur of Geen auteur instellen via de statuskaart bovenaan het rechterpaneel.

Publiceren, geschiedenis en prullenbak

  • Publiceren. Klik op Publiceren (of Wijzigingen publiceren; sneltoets ⌘↵). Voordat het artikel live gaat, waarschuwt de pop-up voor ontbrekende alternatieve tekst bij afbeeldingen of niet-werkende interne links. Schakel bij het bijwerken van een gepubliceerd artikel Weergeven als bijgewerkt uit voor kleine typefouten, zodat de openbare bijgewerkte datum ongewijzigd blijft.

  • Depubliceren. Open Meer acties (⋮) → Depubliceren om de huidige taal offline te halen en het concept en de revisiegeschiedenis te behouden.

  • Versiegeschiedenis. Selecteer een item onder Geschiedenis in de rechterzijbalk om het alleen-lezen te bekijken (druk op Esc om het voorbeeld te sluiten) en klik vervolgens op Deze versie herstellen om het terug te kopiëren naar je concept (het blijft ongepubliceerd totdat je op Wijzigingen publiceren klikt).

  • Vertalingen vergelijken. Schakel bij het bewerken van een vertaald artikel Vergelijken in de bovenste balk in (op brede schermen) om de gepubliceerde brontekst naast de vertaling te bekijken. Gewijzigde, toegevoegde en verwijderde blokken worden gemarkeerd.

  • Verwijderen en herstellen. Open Meer acties (⋮) → Verplaatsen naar prullenbak om een artikel direct te verwijderen. Verwijderde artikelen kunnen 30 dagen worden hersteld; hun slug en omleidingen blijven in die periode gereserveerd. Daarna worden ze definitief verwijderd. Open een verwijderd artikel en klik op de knop Herstellen uit prullenbak.

Volgende stappen

Heeft dit je vraag beantwoord?