website/doc/generate.php

<?php

// Call using something like:
//
//     curl https://www.boost.org/doc/generate.php?page=libs/libraries.htm&version=1.60.0

require_once(__DIR__.'/../common/code/bootstrap.php');

function main($args) {
    if (!array_key_exists('page', $args)) {
        header($_SERVER['SERVER_PROTOCOL'] . ' 400 Missing page argument', true, 400);
        echo "Missing page argument.\n";
        exit(1);
    }

    switch(strtolower(trim($args['page']))) {
    case 'libs/libraries.htm':
    case 'index.html':
        $page = new LibrariesHtm($args);
        $page->display();
        break;
    default:
        header($_SERVER['SERVER_PROTOCOL'] . ' 404 Page not found', true, 404);
        echo "Unknown page: ", htmlentities($args['page']), "\n";
        exit(1);
    }
}

class LibrariesHtm {
    var $args;

    function __construct($args) {
        $this->args = $args;
    }

    function display() {
        $version =
            BoostVersion::parseVersion(
                BoostWebsite::array_get($this->args, 'version')) ?:
            BoostVersion::master();
        $version_string = (string) $version;
        $page = $this->args['page'];
        $libs = BoostLibraries::load();

        // Better support for other branches?
        $repo_dir = BOOST_REPOS_DIR.'/boost-'.
            ($version_string == 'develop' ? 'develop' : 'master').'/';

        if ($version->is_numbered_release()) {
            $source_version = $version;
        }
        else {
            $jamroot = file_get_contents("{$repo_dir}/Jamroot");
            if (!preg_match('@constant BOOST_VERSION : (.*) ;@', $jamroot, $match)) {
                throw new RuntimeException("Unable to find version in Jamroot");
            }
            $source_version = BoostVersion::from($match[1]);
        }

        $categorized = $libs->get_categorized_for_version($version, 'name',
            'BoostLibraries::filter_visible');
        // TODO: Shouldn't really have to sort this here.
        uasort($categorized, function($a, $b) {
            $a = $a['title'];
            $b = $b['title'];
            if ($a === 'Miscellaneous') { $a = 'ZZZZZZZZ'; }
            if ($b === 'Miscellaneous') { $b = 'ZZZZZZZZ'; }
            return ($a > $b) ?: ($a < $b ? -1 : 0);
        });

        $alphabetic = $libs->get_for_version($version, 'name',
            'BoostLibraries::filter_visible');

        $is_develop = $version_string == "develop";

        $params = array(
            'is_develop' => $version_string == "develop",
            'version' => (string) $source_version,
            'minor_release' => $source_version->minor_release(),
            'release_notes_url' => "https://www.boost.org/users/history/version_{$source_version->final_doc_dir()}.html",
            'categorized' => array(),
            'alphabetic' => array(),
            'unreleased_libs' => array(),
            'unreleased_lib_count' => 0,
        );

        foreach($categorized as $category) {
            $template_value = $category;
            $template_value['libraries'] = $this->rewrite_libraries($category['libraries']);
            $params['categorized'][] = $template_value;
        }


        $params['alphabetic'] = $this->rewrite_libraries($alphabetic);

        $unreleased_libs = array();
        if (!$version->is_numbered_release()) {
            foreach ($alphabetic as $library) {
                if ((!$library['boost-version']->is_final_release() &&
                    !$library['boost-version']->is_hidden()) ||
                    $library['boost-version']->minor_release() == $source_version->minor_release())
                {
                    $unreleased_libs[] = $library;
                }
            }
        } else {
            $index = 0;
            foreach ($alphabetic as $library) {
                // Q: Also match point version?
                if ($library['boost-version']->minor_release() == $version->minor_release())
                {
                    $unreleased_libs[] = $library;
                }
            }
        }
        $params['unreleased_libs'] = $this->rewrite_libraries($unreleased_libs);
        $params['unreleased_lib_count'] = count($unreleased_libs);
        $params['unreleased_library_plural'] = !!($params['unreleased_lib_count'] != 1);

        $template_dir = "{$repo_dir}/{$page}";
        echo BoostSimpleTemplate::render(file_get_contents($template_dir),
            $params);
    }

    function rewrite_libraries($libraries) {
        $rewritten = array();
        foreach($libraries as $index => $lib) {
            $lib['index'] = $index;
            $lib['link'] = $this->rewrite_link($lib['documentation']);
            $lib['description'] = rtrim(trim($lib['description']), '.');
            $rewritten[$index] = $lib;
        }
        return $rewritten;
    }

    function rewrite_link($link) {
        $page_parts = explode('/', $this->args['page']);
        array_pop($page_parts);
        $link = trim(preg_replace('@/$@', '/index.html', $link), '/');
        $link_parts = explode('/', $link);
        while ($page_parts && $page_parts[0] == $link_parts[0]) {
            array_shift($page_parts);
            array_shift($link_parts);
        }
        return str_repeat('../', count($page_parts)).implode('/', $link_parts);
    }
}

main($_GET);