{"id":14955553,"url":"https://github.com/opoloo/lines-engine","last_synced_at":"2025-04-09T08:06:51.577Z","repository":{"id":16708399,"uuid":"19465229","full_name":"opoloo/lines-engine","owner":"opoloo","description":"Lines is a customizable blog framework for Rails. It aims at making publishing simple and beautiful.","archived":false,"fork":false,"pushed_at":"2023-10-23T08:30:23.000Z","size":29412,"stargazers_count":216,"open_issues_count":10,"forks_count":102,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-10-29T14:15:22.574Z","etag":null,"topics":["blog","blog-engine","publishing","rails-engine","rails5","ruby"],"latest_commit_sha":null,"homepage":"http://lines.opoloo.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opoloo.png","metadata":{"files":{"readme":"README.rdoc","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"2014-05-05T17:52:34.000Z","updated_at":"2024-07-15T06:55:07.000Z","dependencies_parsed_at":"2024-06-19T11:20:57.656Z","dependency_job_id":"6c0a8e8c-ae63-4e3f-b00a-f429cad6047f","html_url":"https://github.com/opoloo/lines-engine","commit_stats":{"total_commits":306,"total_committers":12,"mean_commits":25.5,"dds":0.1470588235294118,"last_synced_commit":"c47b9f38076c6a0c23e28d322136411a5b577849"},"previous_names":[],"tags_count":60,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opoloo%2Flines-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opoloo%2Flines-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opoloo%2Flines-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opoloo%2Flines-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opoloo","download_url":"https://codeload.github.com/opoloo/lines-engine/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247999859,"owners_count":21031046,"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":["blog","blog-engine","publishing","rails-engine","rails5","ruby"],"created_at":"2024-09-24T13:11:21.426Z","updated_at":"2025-04-09T08:06:51.559Z","avatar_url":"https://github.com/opoloo.png","language":"HTML","readme":"{\u003cimg src=\"http://lines.opoloo.com/assets/images/screenshots/git-logo.png\" /\u003e}[http://lines.opoloo.com/assets/images/screenshots/git-logo.png]\n\n= LINES Publishing Engine by Opoloo[https://www.opoloo.com]\n\n{\u003cimg src=\"https://badge.fury.io/rb/lines-engine.svg\" alt=\"Gem Version\" /\u003e}[http://badge.fury.io/rb/lines-engine]\n\n\n== Introduction\n\nLINES is a customizable publishing framework for Rails developers. It makes your publications and the processes around it simple and beautiful.\n\nLINES is designed for mobile publishing needs. You work in a clear, responsive backend where you write with a distraction-free markdown editor, and where publishing your articles is dead simple. Readers enjoy your writing, not least because it’s perfectly readable on all screens. \n\nLINES is a framework for tech-savvies who care about writing and publishing, with the freedom of full OSS access.\n\nLearn more at the {Lines Website}[http://lines.opoloo.com], or see it in action: https://www.opoloo.com/blog.\n\n\n== Purpose, Features, Specifications\n\nLINES is designed for\n- distraction-free writing and editing\n- a simple, consistent, mobile publishing process\n- clear, responsive presentation\n- customization\n- full focus on content\n\n\n=== Features\n- authentication system (with password reset, remember token, …)\n- custom hero graphics for posts\n- upload default hero images that you want to re-use\n- customizable generic titles \u0026 subtitles\n- automatic teaser \u0026 scaled image for the article overview\n- determine featured article\n- GitHub Flavored Markdown (four headline styles according to priority, italics \u0026 bold text, block quotes and citation, images, lists, links, image captions, …)\n- code syntax highlighting\n- formatting help\n- tags for articles\n- G+ link to social network discussion\n- multiple authors and author information (for your small company or guest authors)\n- add documents for download\n- direct RSS reader access\n\n\n== Installation\n\n1. Add the gem to your Gemfile:\n    gem 'lines-engine'\n\n2. Run 'bundle':\n    bundle\n\n3. There is an installation task that will guide you through the rest of the installation process. Just switch to your application directory and run:\n    rails g lines:install\n\n4. Adjust settings for Lines in the newly generated \u003ctt\u003econfig/lines_config.yml\u003c/tt\u003e file.\n\n5. Run database migrations:\n    rake db:migrate\n\nIf you need some more information or help, you can just follow this read me file.\n\n\n=== Managing admin users\n\nCurrently, LINES does not offer a GUI for managing users, but you can use a rake task to do so:\n\n  rake lines:add_user\n\nTo update an existing user, you’ll need the rails console with 'rails c'\n\n \n=== UPDATE an existing user\n  u = User.find_by_email('your@email.com')\n  u.email = \"new@mail.com\"\n  u.password = \"newsekret\"\n  u.save\n\n\n=== Google Sitemap\n\nThe sitemap_generator gem (https://github.com/kjvarga/sitemap_generator) handles the creation of site maps for search engines. To update the sitemap on server, run:\n\n  bundle exec rake sitemap:refresh:no_ping # don’t ping search engines\n  bundle exec rake sitemap:refresh         # ping search engines\n\nDon’t forget to adjust the full URL to your sitemaps in \u003ctt\u003epublic/robots.txt\u003c/tt\u003e\n\n\n== Documentation\n\nThe complete documentation can be found at RubyDoc.info: http://www.rubydoc.info/gems/lines-engine/\n\n\n== Customization\n\n\n=== Copy/update stylesheets\n\nRun \u003ctt\u003erails g lines:copy_styles\u003c/tt\u003e to install stylesheets from newer gem versions. Keep in mind to backup your overrides and other customizations before doing so!\n\n\n=== Modify CSS/SCSS\n\nFind the SASS files inside the \u003ctt\u003eapp/assets/stylesheets/lines/\u003c/tt\u003e directory. \n\nUse the \u003ctt\u003eapp/assets/stylesheets/lines/lines_overrides.scss\u003c/tt\u003e file to adjust existing styles or add new ones.\n\n=== Modify custom hero images\n\nYou can change, remove, or add the +HERO_IMAGES+ variable inside the \u003ctt\u003econfig/lines_config.yml\u003c/tt\u003e file. The corresponding images reside inside the \u003ctt\u003epublic/heroes\u003c/tt\u003e directory.\n\n\n=== Header (Meta) \u0026 Footer\n\nTo change the header/meta/footer elements you need to modify \u003ctt\u003eapp/views/layouts/lines/application.html.erb\u003c/tt\u003e and the corresponding partials.\n\n\n== Screenshots\n\n=== Dashboard\n{\u003cimg src=\"http://lines.opoloo.com/assets/images/screenshots/git-dashboard.png\" /\u003e}[http://lines.opoloo.com/assets/images/screenshots/git-dashboard.png]\n\n=== Create or edit an article\n\n{\u003cimg src=\"http://lines.opoloo.com/assets/images/screenshots/git-editor.png\" /\u003e}[http://lines.opoloo.com/assets/images/screenshots/git-editor.png]\n\n=== Preview\n\n{\u003cimg src=\"http://lines.opoloo.com/assets/images/screenshots/git-post.png\" /\u003e}[http://lines.opoloo.com/assets/images/screenshots/git-post.png]\n\n=== Articles overview\n\n{\u003cimg src=\"http://lines.opoloo.com/assets/images/screenshots/git-overview.png\" /\u003e}[http://lines.opoloo.com/assets/images/screenshots/git-overview.png]\n\n\n== Contributors\nA big thanks goes to these wonderful people for their contributions and support:\n\n@MyXoToD, @adonespitogo, @scottbarrow, @aziflaj, @dafuga, @usamah82, @edgarlepe\n\n\n== License\n\nYou may use the Lines blog template as you please. You’d make us happy, though, if you kept an attribution to {Lines}[http://lines.opoloo.com/] and {Opoloo}[https://www.opoloo.com] to spread the word.\n \nWe heartily invite you to extend the features of the engine, but when you do, you should fork it on GitHub, so everyone can profit from your work.\n\nYou can see the full license here: http://choosealicense.com/licenses/lgpl-v3/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopoloo%2Flines-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopoloo%2Flines-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopoloo%2Flines-engine/lists"}