{"id":2867,"date":"2022-01-07T19:19:56","date_gmt":"2022-01-07T19:19:56","guid":{"rendered":"https:\/\/castle-engine.io\/wp\/?p=2867"},"modified":"2022-01-07T19:19:56","modified_gmt":"2022-01-07T19:19:56","slug":"pasdoc-new-feature-php-output-useful-for-castle-game-engine-documentation-to-improve-our-api-links","status":"publish","type":"post","link":"https:\/\/castle-engine.io\/wp\/2022\/01\/07\/pasdoc-new-feature-php-output-useful-for-castle-game-engine-documentation-to-improve-our-api-links\/","title":{"rendered":"PasDoc new feature: PHP output, useful for Castle Game Engine documentation to improve our API links"},"content":{"rendered":"<table class=\"thumbnails thumbnails-align-right\"><tr><td>\n          <a href=\"https:\/\/castle-engine.io\/wp\/wp-content\/uploads\/2022\/01\/Zrzut-ekranu-z-2022-01-07-20-16-53.png\"\n             class=\"screenshot\"\n             title=\"PHP map generated by PasDoc\"><img loading=\"lazy\" decoding=\"async\"\n            style=\"float: right\"\n            src=\"https:\/\/castle-engine.io\/wp\/wp-content\/uploads\/2022\/01\/Zrzut-ekranu-z-2022-01-07-20-16-53-200x107.png\"\n             width=\"200\" height=\"107\" \n            alt=\"PHP map generated by PasDoc\"\n          ><\/a><\/td><\/tr><\/table>\n<p>Following my <a href=\"https:\/\/castle-engine.io\/wp\/2021\/12\/31\/many-documentation-upgrades-using-asciidoctor-as-our-primary-way-to-write-documentation-michalis-thoughts-and-plans-about-our-documentation\/\">recent post<\/a>, I am working intensively on CGE documentation updates.<\/p>\n<p><a href=\"https:\/\/pasdoc.github.io\/\">PasDoc<\/a> is a Pascal documentation generator, used by <i>Castle Game Engine<\/i> and many other projects. As it happens, I (Michalis) am also the developer of PasDoc now \ud83d\ude42<\/p>\n<p>To make it easier to develop a certain macro on CGE website, I have added a <a href=\"https:\/\/pasdoc.github.io\/PhpOutput\">PHP output<\/a> to PasDoc. This generates a map, in PHP language, that allows to map Pascal identifier name -> HTML page containing documentation for it. It allows our documentation (using a mix of AsciiDoctor, PHP, WordPress now) to be more aware of CGE API, and easily link\/search to it. See the <a href=\"https:\/\/pasdoc.github.io\/PhpOutput\">documentation of PHP output in PasDoc<\/a> for examples how you can use this.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Following my recent post, I am working intensively on CGE documentation updates. PasDoc is a Pascal documentation generator, used by Castle Game Engine and many other projects. As it happens, I (Michalis) am also the developer of PasDoc now \ud83d\ude42 To make it easier to develop a certain macro on CGE website, I have added &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/castle-engine.io\/wp\/2022\/01\/07\/pasdoc-new-feature-php-output-useful-for-castle-game-engine-documentation-to-improve-our-api-links\/\" class=\"more-link\">Continue reading  \u27a4<span class=\"screen-reader-text\"> &#8220;PasDoc new feature: PHP output, useful for Castle Game Engine documentation to improve our API links&#8221;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":2868,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"publish_to_discourse":"1","publish_post_category":"9","wpdc_auto_publish_overridden":"","wpdc_topic_tags":"","wpdc_pin_topic":"","wpdc_pin_until":"","discourse_post_id":"1669","discourse_permalink":"https:\/\/forum.castle-engine.io\/t\/pasdoc-new-feature-php-output-useful-for-castle-game-engine-documentation-to-improve-our-api-links\/494","wpdc_publishing_response":"","wpdc_publishing_error":"","jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[1],"tags":[],"class_list":["post-2867","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"https:\/\/castle-engine.io\/wp\/wp-content\/uploads\/2022\/01\/Zrzut-ekranu-z-2022-01-07-20-16-53.png","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p9IgYW-Kf","jetpack_likes_enabled":false,"_links":{"self":[{"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/posts\/2867","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/comments?post=2867"}],"version-history":[{"count":4,"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/posts\/2867\/revisions"}],"predecessor-version":[{"id":2872,"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/posts\/2867\/revisions\/2872"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/media\/2868"}],"wp:attachment":[{"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/media?parent=2867"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/categories?post=2867"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/castle-engine.io\/wp\/wp-json\/wp\/v2\/tags?post=2867"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}