projectatomic / docs-projectatomic

Home repository for Atomic Host documentation (both Fedora and CentOS).
Other
5 stars 20 forks source link

Topic map system_containers files' .adoc extensions cause error when building #54

Closed cgmcintyr closed 6 years ago

cgmcintyr commented 6 years ago

Running asciibinder build on root directory results in following error

output

``` Building all distributions. NOTE: The following branches do not exist in your local git repo: - centos The build will proceed but these branches will not be generated. WARNING: The _topic_map.yml file on branch 'master' references nonexistent topics: - tools/system_containers/overview.adoc - tools/system_containers/pull_system_container.adoc - tools/system_containers/installing_system_container.adoc - tools/system_containers/structure.adoc - tools/system_containers/uninstalling_system_container.adoc WARNING: Branch 'master' includes the following .adoc files that are not referenced in the _topic_map.yml file: - attic/atomic-guide/atomic_cli/content/atomic_cli_commands - attic/atomic-guide/atomic_cli/content/atomic_cli_overview - attic/atomic-guide/atomic_cli/master - attic/atomic-guide/container_security_guide/content/building_and_securing - attic/atomic-guide/container_security_guide/content/container_security_practices - attic/atomic-guide/container_security_guide/content/csg - attic/atomic-guide/container_security_guide/content/docker_selinux_security_policy - attic/atomic-guide/container_security_guide/content/leveraging_external_technologies - attic/atomic-guide/container_security_guide/content/lifecycle_of_containers - attic/atomic-guide/container_security_guide/content/overview - attic/atomic-guide/container_security_guide/master - attic/atomic-guide/getting_started_with_containers/content/get_started_docker_formatted_container_images - attic/atomic-guide/getting_started_with_containers/content/simple_apache_web_server_example - attic/atomic-guide/getting_started_with_containers/content/simple_database_server_in_container_example - attic/atomic-guide/getting_started_with_containers/master - attic/atomic-guide/getting_started_with_kubernetes/content/checking_kubernetes - attic/atomic-guide/getting_started_with_kubernetes/content/cleaning_kubernetes - attic/atomic-guide/getting_started_with_kubernetes/content/create_kube_cluster_to_run_docker_images - attic/atomic-guide/getting_started_with_kubernetes/content/get_started_orchestrating_containers_with_kube - attic/atomic-guide/getting_started_with_kubernetes/content/get_started_provisioning_storage_kube - attic/atomic-guide/getting_started_with_kubernetes/content/kube_config - attic/atomic-guide/getting_started_with_kubernetes/content/migrating_kubernetes - attic/atomic-guide/getting_started_with_kubernetes/content/troubleshooting_kube - attic/atomic-guide/getting_started_with_kubernetes/content/yaml_in_a_nutshell - attic/atomic-guide/getting_started_with_kubernetes/master - attic/atomic-guide/installation_and_configuration_guide/content/adding_software - attic/atomic-guide/installation_and_configuration_guide/content/anaconda_installation - attic/atomic-guide/installation_and_configuration_guide/content/atomic_host - attic/atomic-guide/installation_and_configuration_guide/content/cloud-init-faq - attic/atomic-guide/installation_and_configuration_guide/content/developer_mode - attic/atomic-guide/installation_and_configuration_guide/content/kickstart_installation - attic/atomic-guide/installation_and_configuration_guide/content/operating_system_content - attic/atomic-guide/installation_and_configuration_guide/content/post_installation_configuration - attic/atomic-guide/installation_and_configuration_guide/content/pxe_installation - attic/atomic-guide/installation_and_configuration_guide/content/registering_rhel_ah - attic/atomic-guide/installation_and_configuration_guide/content/system_requirements - attic/atomic-guide/installation_and_configuration_guide/content/types_of_installation - attic/atomic-guide/installation_and_configuration_guide/content/upgrading_and_downgrading - attic/atomic-guide/installation_and_configuration_guide/content/virtual_machine_installations - attic/atomic-guide/installation_and_configuration_guide/master - attic/atomic-guide/managing_containers/content/managing_storage_docker_formatted_containers - attic/atomic-guide/managing_containers/content/running_containers_with_runc - attic/atomic-guide/managing_containers/content/signing_container_images - attic/atomic-guide/managing_containers/content/super_privileged_containers - attic/atomic-guide/managing_containers/content/system_containers - attic/atomic-guide/managing_containers/content/using_atomic_etcd_container_image - attic/atomic-guide/managing_containers/content/using_atomic_etcd_system_container_image - attic/atomic-guide/managing_containers/content/using_atomic_flannel_system_container_image - attic/atomic-guide/managing_containers/content/using_atomic_rhe_agent_container_image - attic/atomic-guide/managing_containers/content/using_atomic_rsyslog_container_image - attic/atomic-guide/managing_containers/content/using_atomic_sadc_container_image - attic/atomic-guide/managing_containers/content/using_atomic_sssd_container_image - attic/atomic-guide/managing_containers/content/using_atomic_tools_container_image - attic/atomic-guide/managing_containers/content/using_systemd_with_containers - attic/atomic-guide/managing_containers/master - attic/atomic-guide/overview_of_containers/content/introduction_to_linux_containers - attic/atomic-guide/overview_of_containers/master - attic/atomic-guide/recommended_practices_container_devel/content/recommended_practices_for_container_development - attic/atomic-guide/recommended_practices_container_devel/master - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-7 - attic/atomic-guide/release_notes/content/release_notes-AMIs - attic/atomic-guide/release_notes/content/release_notes-known_issues - attic/atomic-guide/release_notes/content/release_notes-overview - attic/atomic-guide/release_notes/content/release_notes-technology_previews - attic/atomic-guide/release_notes/master - attic/atomic-guide/retired/getting_started_guide/content/configuring_rhel_ah - attic/atomic-guide/retired/getting_started_guide/content/overview - attic/atomic-guide/retired/getting_started_guide/content/registering_rhel_ah - attic/atomic-guide/retired/getting_started_guide/content/simple_apache_web_server_example - attic/atomic-guide/retired/getting_started_guide/content/simple_database_server_in_container_example - attic/atomic-guide/retired/getting_started_guide/content/system_requirements - attic/atomic-guide/retired/getting_started_guide/content/upgrade_and_rollback - attic/atomic-guide/retired/getting_started_guide/master - attic/atomic-guide/style - attic/atomic-guide/templates/master - attic/atomic-guide/templates/topic_template - tools/cockpit/master - tools/system_containers/installing_system_container - tools/system_containers/master - tools/system_containers/overview - tools/system_containers/pull_system_container - tools/system_containers/structure - tools/system_containers/uninstalling_system_container Building CentOS Atomic Host for branch 'master' - welcome/index.adoc - installation/vagrant.adoc asciidoctor: WARNING: : line 13: section title out of sequence: expected level 1, got level 2 asciidoctor: WARNING: : line 39: section title out of sequence: expected level 1, got level 2 - tools/cockpit/overview.adoc - tools/cockpit/installing_cockpit.adoc asciidoctor: WARNING: : line 27: list item index: expected 2, got 1 asciidoctor: WARNING: : line 34: list item index: expected 3, got 1 asciidoctor: WARNING: : line 40: list item index: expected 4, got 1 asciidoctor: WARNING: : line 55: list item index: expected 2, got 1 - tools/cockpit/using_cockpit.adoc asciidoctor: WARNING: : line 115: section title out of sequence: expected level 2, got level 3 asciidoctor: WARNING: : line 141: section title out of sequence: expected level 2, got level 3 - tools/system_containers/overview.adoc.adoc Error: Could not generate docs: Errno::ENOENT: No such file or directory @ rb_sysopen - /usr/src/docs/tools/system_containers/overview.adoc.adoc at /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:447:in `initialize' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:447:in `open' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:447:in `configure_and_generate_page' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:440:in `block in process_topic_entity_list' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:429:in `each' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:429:in `process_topic_entity_list' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:435:in `block in process_topic_entity_list' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:429:in `each' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:429:in `process_topic_entity_list' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:435:in `block in process_topic_entity_list' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:429:in `each' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:429:in `process_topic_entity_list' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:392:in `block (2 levels) in generate_docs' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:344:in `each' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:344:in `block in generate_docs' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:308:in `each' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/lib/ascii_binder/engine.rb:308:in `generate_docs' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/bin/asciibinder:17:in `call_generate' /opt/rh/rh-ruby22/root/usr/local/share/gems/gems/ascii_binder-0.1.10.1/bin/asciibinder:300:in `' /opt/rh/rh-ruby22/root/usr/local/bin/asciibinder:23:in `load' /opt/rh/rh-ruby22/root/usr/local/bin/asciibinder:23:in `

'. Try --help for help. ```


The problem stems from the .adoc extension at the end of each File name under the _topic_map.yml System Containers Topic (lines 50 -62).

Removing the .adoc from the end of the filenames allows for asciibinder to generate the _preview directory without errors.