Support for building a specific topic group or book (top-level topic group)

[gabriel-rh]

At the moment, asciibinder builds all topic maps that exist in the _topic_maps folder (depending on the distros chosen)

Alternatively, you can use the --page option to build a single page, which hugely reduces build resources

However, if you edit many modules in a PR, then the --page option is harder to use and requires working backwards up the tree to figure out what pages have changed and requires creating multiple page builds.

It would be good to be able to build a specific book (top-level topic group), so that you don't have to end up building lots of individual pages, while at the same time avoiding the >>2GB full preview build.

Most books are <25MB, so just building a single book could require 1/100th of the resources versus a full preview.

Book sizes:

$ du -sh ./_preview/openshift-enterprise/main/* | sort -h

40K	./_preview/openshift-enterprise/main/_javascripts
288K	./_preview/openshift-enterprise/main/_stylesheets
964K	./_preview/openshift-enterprise/main/release_notes
1.3M	./_preview/openshift-enterprise/main/_images
3.9M	./_preview/openshift-enterprise/main/hardware_enablement
4.3M	./_preview/openshift-enterprise/main/welcome
6.7M	./_preview/openshift-enterprise/main/sandboxed_containers
6.9M	./_preview/openshift-enterprise/main/distr_tracing
8.0M	./_preview/openshift-enterprise/main/getting_started
8.5M	./_preview/openshift-enterprise/main/architecture
9.8M	./_preview/openshift-enterprise/main/updating
10M	./_preview/openshift-enterprise/main/web_console
11M	./_preview/openshift-enterprise/main/migration_toolkit_for_containers
11M	./_preview/openshift-enterprise/main/monitoring
11M	./_preview/openshift-enterprise/main/registry
12M	./_preview/openshift-enterprise/main/post_installation_configuration
12M	./_preview/openshift-enterprise/main/windows_containers
13M	./_preview/openshift-enterprise/main/migrating_from_ocp_3_to_4
19M	./_preview/openshift-enterprise/main/backup_and_restore
19M	./_preview/openshift-enterprise/main/openshift_images
20M	./_preview/openshift-enterprise/main/scalability_and_performance
22M	./_preview/openshift-enterprise/main/machine_management
23M	./_preview/openshift-enterprise/main/cli_reference
24M	./_preview/openshift-enterprise/main/support
27M	./_preview/openshift-enterprise/main/logging
31M	./_preview/openshift-enterprise/main/authentication
35M	./_preview/openshift-enterprise/main/storage
36M	./_preview/openshift-enterprise/main/applications
39M	./_preview/openshift-enterprise/main/service_mesh
45M	./_preview/openshift-enterprise/main/cicd
55M	./_preview/openshift-enterprise/main/nodes
58M	./_preview/openshift-enterprise/main/operators
60M	./_preview/openshift-enterprise/main/serverless
63M	./_preview/openshift-enterprise/main/security
105M	./_preview/openshift-enterprise/main/networking
112M	./_preview/openshift-enterprise/main/virt
139M	./_preview/openshift-enterprise/main/installing
246M	./_preview/openshift-enterprise/main/rest_api

[rohennes]

I have replicated the issue with my local asciibinder build. Using @gabriel-rh's container image with his updated version of asciibinder, I verified the fixes worked as expected.