{"id":26457852,"url":"https://github.com/emilfreme/gdocs2jekyll","last_synced_at":"2025-08-18T11:10:09.129Z","repository":{"id":65524863,"uuid":"421164330","full_name":"EmilFreme/gdocs2jekyll","owner":"EmilFreme","description":"This is a simple Tags Plugin for Jekyll to include the contents of a Google Docs file in a Jekyll page without the necessity to use the iframe required to embed the document.","archived":false,"fork":false,"pushed_at":"2022-06-13T18:27:18.000Z","size":110,"stargazers_count":6,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-27T18:57:50.043Z","etag":null,"topics":["gdocs","jekyll","jekyll-plugin","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EmilFreme.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-25T19:49:33.000Z","updated_at":"2024-07-29T05:22:39.000Z","dependencies_parsed_at":"2023-01-27T07:45:27.037Z","dependency_job_id":null,"html_url":"https://github.com/EmilFreme/gdocs2jekyll","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/EmilFreme/gdocs2jekyll","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmilFreme%2Fgdocs2jekyll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmilFreme%2Fgdocs2jekyll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmilFreme%2Fgdocs2jekyll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmilFreme%2Fgdocs2jekyll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EmilFreme","download_url":"https://codeload.github.com/EmilFreme/gdocs2jekyll/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmilFreme%2Fgdocs2jekyll/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270982194,"owners_count":24679447,"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-08-18T02:00:08.743Z","response_time":89,"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":["gdocs","jekyll","jekyll-plugin","ruby"],"created_at":"2025-03-18T23:52:52.253Z","updated_at":"2025-08-18T11:10:09.088Z","avatar_url":"https://github.com/EmilFreme.png","language":"Ruby","readme":"# Gdocs2jekyll\n\nThis is a simple Tags Plugin for [Jekyll](https://jekyllrb.com/) to include the\ncontents of a Google Docs file in a Jekyll page without the necessity to use the\n iframe required to embed the document. \n\nThis plugin aims to maintain the use of the google docs for their features, like comments\nease to paste pictures and so on, as well as delivery a better experience for\nthe handouts included in a Jekyll managed website.\n\n\n## Installation\n\nInstall the gem and add to the application's Gemfile by executing:\n\n    $ bundle add gdocs2jekyll\n\nIf bundler is not being used to manage dependencies, install the gem by executing:\n\n    $ gem install gdocs2jekyll\n\nput this in your `_config.yml`\n\n```\nplugins: [gdocs2jekyll]\n```\n\nFinally, create a API Key in your Google Cloud Platform, with access to the Google Docs API, and set the `GOOGLE_DRIVE_API_KEY` environment variable \n\n```\nexport GOOGLE_DRIVE_API_KEY=\"your_generated_api_key\"\n```\n\nWithout this step, the tag won't generate any content.\n\n## Usage\n\nIn your md file just use the tag \n\n```\n{% gdocs2jekyll \u003cyour document id\u003e %}\n```\n\nThe document ID can be found in the URL of your gdrive doc: \n\n![](gdriveurl.png)\n\n### Comparison iframe embeded vs gdocs2jekyll jekyll tag\n\nThe ugly iframe solution with 2 scrolls and not so good awful responsiveness\n\n![](iframesample.png)\n\ngdocs2jekyll inserting the content \"natively\" in the page\n\n![](tagsample.png)\n\n\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/EmilFreme/gdocs2jekyll. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/EmilFreme/gdocs2jekyll/blob/master/CODE_OF_CONDUCT.md).\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n## Code of Conduct\n\nEveryone interacting in the Gdocs2jekyll project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/EmilFreme/gdocs2jekyll/blob/master/CODE_OF_CONDUCT.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femilfreme%2Fgdocs2jekyll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femilfreme%2Fgdocs2jekyll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femilfreme%2Fgdocs2jekyll/lists"}