{"id":2128,"date":"2026-05-26T06:46:41","date_gmt":"2026-05-26T06:46:41","guid":{"rendered":"https:\/\/www.vpascode.com\/pl\/docs\/uncategorized\/plantuml-syntax-basics\/"},"modified":"2026-05-26T06:46:41","modified_gmt":"2026-05-26T06:46:41","slug":"plantuml-syntax-basics","status":"publish","type":"ld_docs","link":"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/","title":{"rendered":"Podstawy sk\u0142adni PlantUML"},"content":{"rendered":"<p>Zanim przejdziemy do konkretnych uk\u0142ad\u00f3w architektonicznych, takich jak modele C4 lub przebiegi sekwencji, istotne jest zrozumienie podstawowych zasad, kt\u00f3re reguluj\u0105<strong>Playbook PlantUML<\/strong>. PlantUML opiera si\u0119 na czystym, bardzo intuicyjnym systemie notacji tekstowej. Gdy zrozumiesz, jak silnik otwiera dokumenty, nadaje nazwy elementom strukturalnym i kieruje linie po\u0142\u0105cze\u0144, tworzenie uk\u0142adu dowolnego z\u0142o\u017conego systemu staje si\u0119 zupe\u0142nie naturalne.<\/p>\n<p>Ten szybki przewodnik obejmuje globalne mechanizmy sk\u0142adni strukturalnej, kt\u00f3re stosuje si\u0119 we wszystkich typach diagram\u00f3w PlantUML w \u015brodowisku VPasCode.<\/p>\n<h2>1. Obowi\u0105zkowe otoki dokumentu<\/h2>\n<p>Ka\u017cdy blok kodu PlantUML musi zaczyna\u0107 si\u0119 i ko\u0144czy\u0107 jawnymi znacznikami frameworku. Te znaczniki informuj\u0105 parser VPasCode o uruchomieniu odpowiedniego silnika renderowania na kanwie podgl\u0105du:<\/p>\n<ul>\n<li><code>@startuml<\/code> \u2014 Ta dok\u0142adna linia musi znajdowa\u0107 si\u0119 na samym pocz\u0105tku skryptu. Niczego nie mo\u017ce jej poprzedza\u0107.<\/li>\n<li><code>@enduml<\/code> \u2014 Ta dok\u0142adna linia musi znajdowa\u0107 si\u0119 na samym ko\u0144cu skryptu, oznaczaj\u0105c zako\u0144czenie bloku danych diagramu.<\/li>\n<\/ul>\n<p>Ka\u017cdy kod napisany poza tymi dwoma znacznikami zostanie bezpiecznie zignorowany przez kompilator, albo mo\u017ce spowodowa\u0107 ostrze\u017cenie weryfikacji sk\u0142adni w panelu diagnostycznym \u015brodowiska pracy.<\/p>\n<h2>2. Deklarowanie element\u00f3w: ID w por\u00f3wnaniu z etykietami wy\u015bwietlania<\/h2>\n<p>Podczas modelowania systemu oprogramowania tworzysz r\u00f3\u017cne elementy strukturalne, takie jak sk\u0142adniki, bazy danych, aktorzy lub mikroserwisy. W PlantUML mo\u017cesz jawnie zadeklarowa\u0107 element, definiuj\u0105c jego typ, wewn\u0119trzny skr\u00f3t ID oraz przyjazn\u0105 dla u\u017cytkownika nazw\u0119 wy\u015bwietlania uj\u0119t\u0105 w cudzys\u0142owy:<\/p>\n<pre><code>component microservice_id jako \"Payment Processing API\"\r\ndatabase db_id jako \"User Transaction SQL\"<\/code><\/pre>\n<p><strong>Dlaczego jest to najlepsza praktyka:<\/strong> U\u017cywanie kr\u00f3tkiego, czystego wewn\u0119trznego ID (takiego jak<code>microservice_id<\/code>) znacznie przyspiesza rysowanie linii relacji w przysz\u0142o\u015bci. Je\u015bli kiedykolwiek b\u0119dziesz musia\u0142 zmieni\u0107 etykiet\u0119 widoczn\u0105 dla klienta z \u201ePayment Processing API\u201d na \u201eGlobal Checkout Service\u201d, musisz zmieni\u0107 j\u0105 tylko w jednym wierszu kodu, a nie aktualizowa\u0107 dziesi\u0105tki linii w ca\u0142ym skrypcie.<\/p>\n<h2>3. Opanowanie strza\u0142ek relacji i kierunkowego routingu<\/h2>\n<p>Po\u0142\u0105czenia mi\u0119dzy w\u0119z\u0142ami systemu rysuje si\u0119 za pomoc\u0105 kombinacji kresek (<code>-<\/code>) i nawias\u00f3w strza\u0142ek (<code>&gt;<\/code>). D\u0142ugo\u015b\u0107 kresek i uwzgl\u0119dnienie s\u0142\u00f3w kluczowych kierunkowych daj\u0105 Ci po\u015bredni kontrol\u0119 nad tym, jak silnik automatycznego uk\u0142adu skaluje Tw\u00f3j diagram:<\/p>\n<ul>\n<li><strong>Podstawowe po\u0142\u0105czenia:<\/strong> <code>A --&gt; B<\/code> rysuje standardow\u0105 strza\u0142k\u0119 kierunkow\u0105 wskazuj\u0105c\u0105 od elementu A bezpo\u015brednio do elementu B.<\/li>\n<li><strong>Linie zale\u017cno\u015bci kropkowane:<\/strong> Zast\u0119powanie kresek kropkami tworzy lini\u0119 kropkowan\u0105, kt\u00f3ra jest standardem bran\u017cowym wskazuj\u0105cym na zale\u017cno\u015bci asynchroniczne lub wywo\u0142ania sieciowe:<code>A ..&gt; B<\/code>.<\/li>\n<li><strong>Wymuszanie orientacji uk\u0142adu:<\/strong> Chocia\u017c silnik uk\u0142adu automatycznie rozdziela pola, mo\u017cesz jawnie kontrolowa\u0107 orientacj\u0119, wstawiaj\u0105c s\u0142owo kluczowe kierunku bezpo\u015brednio w ci\u0105gu strza\u0142ki:\n<ul>\n<li><code>A -up-&gt; B<\/code> (Wymusza renderowanie B powy\u017cej A)<\/li>\n<li><code>A -down-&gt; B<\/code> (Wymusza renderowanie B poni\u017cej A)<\/li>\n<li><code>A -left-&gt; B<\/code> (Wymusza renderowanie B po lewej stronie A)<\/li>\n<li><code>A -right-&gt; B<\/code> (Wymusza renderowanie B po prawej stronie A)<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>4. Dodawanie kontekstu w linii: etykiety i komentarze kodu<\/h2>\n<p>Jasna dokumentacja bardzo du\u017co zale\u017cy na umieszczaniu odpowiedniego kontekstu wok\u00f3\u0142 Twoich linii wizualnych i skrypt\u00f3w tekstowych:<\/p>\n<h3>Etykietowanie linii po\u0142\u0105cze\u0144<\/h3>\n<p>Mo\u017cesz doda\u0107 obja\u015bniaj\u0105cy tekst bezpo\u015brednio do dowolnej linii po\u0142\u0105czenia, dodaj\u0105c dwukropek (&#8220;<code>:<\/code>) tu\u017c po swoim mapowaniu relacji:<\/p>\n<pre><code>client_id --&gt; api_id : \"HTTPS POST \/v1\/checkout\"<\/code><\/pre>\n<h3>Pisanie komentarzy kodu<\/h3>\n<p>Je\u015bli chcesz zostawi\u0107 notatk\u0119 administracyjn\u0105, credit projektowy lub wyja\u015bnienie architektoniczne w pliku skryptu bez renderowania pola wizualnego na p\u0142\u00f3tnie, u\u017cyj znaku pojedynczego cudzys\u0142owu (&#8220;<code>'<\/code>). Informuje to silnik, aby ca\u0142kowicie pomin\u0105\u0142 analiz\u0119 tej linii:<\/p>\n<pre><code>' TODO: Musimy zaktualizowa\u0107 to pole graniczne, gdy zako\u0144czy si\u0119 migracja DevOps\r\n[Stary monolit] --&gt; [Nowy mikroserwis]<\/code><\/pre>\n<p>Teraz, gdy znasz og\u00f3lne sk\u0142adnie otoczki, deklaracje komponent\u00f3w i parametry strza\u0142ek kierunkowych PlantUML, jeste\u015b idealnie przygotowany, aby rozpocz\u0105\u0107 budowanie zaawansowanych kszta\u0142t\u00f3w systemu. Przejd\u017a do nast\u0119pnej strony, aby odblokowa\u0107 nasz\u0105 kolekcj\u0119 <strong>Diagramy architektury i projektowania najwy\u017cszego poziomu<\/strong>!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Zanim przejdziemy do konkretnych uk\u0142ad\u00f3w architektonicznych, takich jak modele C4 lub przebiegi sekwencji, istotne jest zrozumienie podstawowych zasad, kt\u00f3re reguluj\u0105Playbook PlantUML. PlantUML opiera si\u0119 na czystym, bardzo intuicyjnym systemie notacji tekstowej. Gdy zrozumiesz, jak silnik otwiera dokumenty, nadaje nazwy elementom&#8230;<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":0,"menu_order":0,"template":"","meta":{"inline_featured_image":false,"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"ld_collection":[14],"class_list":["post-2128","ld_docs","type-ld_docs","status-publish","hentry","ld_collection-vpascode-docs"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>PlantUML Syntax Basics | VPasCode Text to Diagram Guide<\/title>\n<meta name=\"description\" content=\"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/\" \/>\n<meta property=\"og:locale\" content=\"pl_PL\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PlantUML Syntax Basics | VPasCode Text to Diagram Guide\" \/>\n<meta property=\"og:description\" content=\"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/\" \/>\n<meta property=\"og:site_name\" content=\"VPasCode\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Szacowany czas czytania\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minuty\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\",\"name\":\"PlantUML Syntax Basics | VPasCode Text to Diagram Guide\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/#website\"},\"datePublished\":\"2026-05-26T06:46:41+00:00\",\"description\":\"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/#breadcrumb\"},\"inLanguage\":\"pl-PL\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/docs\\\/vpascode-docs\\\/plantuml-syntax-basics\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Lean Docs\",\"item\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/docs\\\/%ld_collection%\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Podstawy sk\u0142adni PlantUML\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/#website\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/\",\"name\":\"VPasCode\",\"description\":\"by Visual Paradigm\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"pl-PL\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/#organization\",\"name\":\"VPasCode\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pl-PL\",\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/wp-content\\\/uploads\\\/sites\\\/9\\\/2026\\\/06\\\/cropped-vp-online-logo-v1.png\",\"contentUrl\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/wp-content\\\/uploads\\\/sites\\\/9\\\/2026\\\/06\\\/cropped-vp-online-logo-v1.png\",\"width\":128,\"height\":138,\"caption\":\"VPasCode\"},\"image\":{\"@id\":\"https:\\\/\\\/www.vpascode.com\\\/pl\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PlantUML Syntax Basics | VPasCode Text to Diagram Guide","description":"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/","og_locale":"pl_PL","og_type":"article","og_title":"PlantUML Syntax Basics | VPasCode Text to Diagram Guide","og_description":"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.","og_url":"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/","og_site_name":"VPasCode","twitter_card":"summary_large_image","twitter_misc":{"Szacowany czas czytania":"3 minuty"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/","url":"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/","name":"PlantUML Syntax Basics | VPasCode Text to Diagram Guide","isPartOf":{"@id":"https:\/\/www.vpascode.com\/pl\/#website"},"datePublished":"2026-05-26T06:46:41+00:00","description":"Master PlantUML syntax fundamentals in VPasCode, a versatile diagram-as-code tool to convert text to diagram architecture maps.","breadcrumb":{"@id":"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/#breadcrumb"},"inLanguage":"pl-PL","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-syntax-basics\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.vpascode.com\/pl\/"},{"@type":"ListItem","position":2,"name":"Lean Docs","item":"https:\/\/www.vpascode.com\/pl\/docs\/%ld_collection%\/"},{"@type":"ListItem","position":3,"name":"Podstawy sk\u0142adni PlantUML"}]},{"@type":"WebSite","@id":"https:\/\/www.vpascode.com\/pl\/#website","url":"https:\/\/www.vpascode.com\/pl\/","name":"VPasCode","description":"by Visual Paradigm","publisher":{"@id":"https:\/\/www.vpascode.com\/pl\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.vpascode.com\/pl\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"pl-PL"},{"@type":"Organization","@id":"https:\/\/www.vpascode.com\/pl\/#organization","name":"VPasCode","url":"https:\/\/www.vpascode.com\/pl\/","logo":{"@type":"ImageObject","inLanguage":"pl-PL","@id":"https:\/\/www.vpascode.com\/pl\/#\/schema\/logo\/image\/","url":"https:\/\/www.vpascode.com\/pl\/wp-content\/uploads\/sites\/9\/2026\/06\/cropped-vp-online-logo-v1.png","contentUrl":"https:\/\/www.vpascode.com\/pl\/wp-content\/uploads\/sites\/9\/2026\/06\/cropped-vp-online-logo-v1.png","width":128,"height":138,"caption":"VPasCode"},"image":{"@id":"https:\/\/www.vpascode.com\/pl\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.vpascode.com\/pl\/wp-json\/wp\/v2\/ld_docs\/2128","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.vpascode.com\/pl\/wp-json\/wp\/v2\/ld_docs"}],"about":[{"href":"https:\/\/www.vpascode.com\/pl\/wp-json\/wp\/v2\/types\/ld_docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.vpascode.com\/pl\/wp-json\/wp\/v2\/users\/4"}],"wp:attachment":[{"href":"https:\/\/www.vpascode.com\/pl\/wp-json\/wp\/v2\/media?parent=2128"}],"wp:term":[{"taxonomy":"ld_collection","embeddable":true,"href":"https:\/\/www.vpascode.com\/pl\/wp-json\/wp\/v2\/ld_collection?post=2128"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}