{"id":19357043,"url":"https://github.com/kaaproject/jekver","last_synced_at":"2025-08-15T18:44:42.450Z","repository":{"id":76973565,"uuid":"77233766","full_name":"kaaproject/jekver","owner":"kaaproject","description":null,"archived":false,"fork":false,"pushed_at":"2024-08-29T15:12:11.000Z","size":365,"stargazers_count":0,"open_issues_count":0,"forks_count":11,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-02T14:11:16.902Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/kaaproject.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2016-12-23T15:25:43.000Z","updated_at":"2024-08-29T15:12:15.000Z","dependencies_parsed_at":"2023-02-27T05:45:55.455Z","dependency_job_id":null,"html_url":"https://github.com/kaaproject/jekver","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaaproject%2Fjekver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaaproject%2Fjekver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaaproject%2Fjekver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaaproject%2Fjekver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kaaproject","download_url":"https://codeload.github.com/kaaproject/jekver/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250416948,"owners_count":21427097,"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","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":"2024-11-10T07:06:08.553Z","updated_at":"2025-04-23T10:33:03.356Z","avatar_url":"https://github.com/kaaproject.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jekver\n\nTool to collect documentation from versions tags and update gh-pages branch in target repository\n\n## Configuration\n\n### CLI options\n\nRun jekver with -h options to get latest cli help.\n\nCLI overwrite configuraton loaded from config file so if option defined in config file and passed from CLI jekver will be excuted with values from CLI.\n\n### Configuration file\n\n|path|Type|Example|Comments|\n|---|---|---|---|\n|project|String|kaa|Project name|\n|startFromTag|String|v0.8.1|Minimal version to collect documents|\n|latest|String|v0.10.0|Latest version to generate redirection pages|\n|addCurrent|boolean|false|Flag to add current branch to the gh-pages|\n|jekdocs|Array||Conversion rules to generate documentation|\n|jekdocs[n].key|Map||Configuration Item|\n|jekdocs[n].key.cmd|String|\"mvn compile\"|Command to generate documentation|\n|jekdocs[n].key.path|String|\"path_to_mvm_proj\"|Base path from cmd should be executed|\n|jekdocs[n].key.target|String|\"\"|Target folder for documentation in gh-pages|\n|jekdocs[n].key.copy|Map|dst:src|Coping rules in format destination source #{version}/#{path}/#{src}/ -\u003e #{key}/#{target}/#{dst}/#{version}|\n\n## Basic usage\n\n1. Install Bundler to manage Ruby gems required for Jekver:\n   ```\n   gem install bundler\n   ```\n\n2. Clone [Jekver repository](https://github.com/kaaproject/jekver) to the directory that contains your project repository with documentation.\n\n3. Install required Jekyll dependencies by running this command from the Jekver repository that you cloned in the previous step:\n   ```\n   bundle install --gemfile ./Gemfile\n   ```\n\n4. In the cloned Jekver repository, open the `gh-pages-stub/_config.yml` file, specify `title` and `baseurl` parameter values for your project.\n\n5. Create a Jekver configuration file `jekver.yml` in the root of your project repository with documentation.\nFor the `docs` parameter, specify the name of the directory that contains your documentation.\nIf that directory is not in the project root, specify the full path from project root.\nSee example below.\n\n   ```\n   project: MyProject\n   latest: \"current\"\n   \n   jekdocs:\n    - md:\n        path: \"\"\n        target: \"\"\n        copy:\n          docs: doc\n   ```\n\n6. From the root of your cloned Jekver repository, run:\n\n   ```\n   ./jekver.rb -c \u003croot path of your project repository\u003e\n   ```\n\n   This will generate documentation structure and create two sub-directories in the root of your project repository: `test-MyProject-pages-current` and `tmp`.\n\n7. From the `test-MyProject-pages-current` directory, run `jekyll serve`.\nThis will generate the documentation and serve it at `http://localhost:4000/\u003cbaseurl\u003e/`.\n\n### Regenerate documentation after editing\n\nYou can use Jekver to locally view the changes you have made to your project documentation.\nTo do this, you need to regenerate your project documentation after you have made the changes:\n\n 1. Stop Jekver from running (press Ctrl+C in the same terminal where you previously run `jekyll serve`).\n\n 2. Delete the `test-...-pages` and  `tmp` directories from your project directory.\n\n 3. From Jekver repository, run:\n    ```\n    ./jekver.rb --c \u003croot path of your project repository\u003e\n    ```\n\n 4. Go to the `test-...-pages` directory in the root of your project and serve the documentation regenerated in the previous step:\n    ```\n    cd ..\n    cd ./test-gh-pages-current/\n    jekyll serve\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaaproject%2Fjekver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaaproject%2Fjekver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaaproject%2Fjekver/lists"}