{"id":32210673,"url":"https://github.com/domm/blio","last_synced_at":"2025-10-22T06:38:26.401Z","repository":{"id":4236182,"uuid":"5360037","full_name":"domm/Blio","owner":"domm","description":"my blogging \"engine\"","archived":false,"fork":false,"pushed_at":"2024-10-20T18:44:27.000Z","size":785,"stargazers_count":17,"open_issues_count":1,"forks_count":5,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-20T22:52:47.580Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/domm.png","metadata":{"files":{"readme":"README.md","changelog":"Changes","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-08-09T19:18:12.000Z","updated_at":"2024-10-20T18:44:29.000Z","dependencies_parsed_at":"2024-10-20T22:35:20.674Z","dependency_job_id":null,"html_url":"https://github.com/domm/Blio","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/domm/Blio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domm%2FBlio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domm%2FBlio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domm%2FBlio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domm%2FBlio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/domm","download_url":"https://codeload.github.com/domm/Blio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domm%2FBlio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280395277,"owners_count":26323515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-22T02:00:06.515Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-22T06:38:23.912Z","updated_at":"2025-10-22T06:38:26.393Z","avatar_url":"https://github.com/domm.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAME\n\nBlio - domms blogging \"engine\"\n\n# VERSION\n\nversion 2.009\n\n# SYNOPSIS\n\nBackend for the `blio.pl` command. See [blio.pl](https://metacpan.org/pod/blio.pl) and/or `perldoc blio.pl` for details.\n\nmore docs pending...\n\ndocs provided by gabor, need to be integrated:\n\n# CONFIGURATION\n\nThe configuration parameters can be provided either in the configuration file that defauts to blio.ini\nor on the command line.\n\nThe configuration file can look like this:\n\n    name=Test site\n    source_dir=src/\n    output_dir=.\n    template_dir=templates/\n\nThe configureation file must exists.\nOtherwise you will get a warning like this:\n\n    Specified configfile 'blio.ini' does not exist, is empty, or is not readable\n\nIf no source\\_dir provided or there is no src/ directory, you get this exception:\n\n    Can't call method \"done\" on an undefined value at .../Blio.pm line 137.\n\n- name\n\n    The name of the site in the title of the pages. Default to Blio\n\n- source\\_dir\n\n    The directory where the source files are. Each page of the site has a corresponding source file with .txt extension.\n    Defaults to the `src/` directory relative to the current working directory where your run the `build.pl` script.\n\n- output\\_dir\n\n    Directory where the generated html files should go. Defaults to `out/` relative to the current working directory.\n\n- template\\_dir\n\n    The location of the template files. Defaults to `templates/` relative to the current working directory.\n    As a fallback, there is a set of templates provided by Blio. They come in the share/templates directory of\n    the distribution and are installed along the module.\n\n- site\\_url\n- site\\_author\n- converter\n- thumbnail\n\nTODO - there are more fields that need explanation.\n\n## Source directory hierarchy\n\nThe source directory defined using the `source_dir` paramater can havs subdirectories, but each subdirectory needs\na 'parent' page. The name of the parent page is the same as the name of the subdirectory with the additional .txt\nextentsion. So if you'd like to have a `src/project/`  subdriectory, you also need to have a page called\n`src/project.txt`.\n\nIf there is no index.txt in the src/ directory, Blio will generate a default index.html file.\nThis is not the case with subdirectories.\n\n## Source files\n\nEach source file has a txt extension. It has several lines of header and a body.\nThe module that represents each file is [Blio::Node](https://metacpan.org/pod/Blio%3A%3ANode).\n\n    title: The Project\n    date: 2013-02-10T00:27:53\n    language: en\n    converter: textile\n    tags: Perl\n\n    This is the project page.\n\nThe only required entry in the header is the `title`.\n\nTODO - there are more fields that need explanation.\n\n# AUTHOR\n\nThomas Klausner \u003cdomm@plix.at\u003e\n\n# COPYRIGHT AND LICENSE\n\nThis software is copyright (c) 2013 - 2025 by Thomas Klausner.\n\nThis is free software; you can redistribute it and/or modify it under\nthe same terms as the Perl 5 programming language system itself.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomm%2Fblio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdomm%2Fblio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomm%2Fblio/lists"}