{"id":17305455,"url":"https://github.com/kovah/corporatelorem","last_synced_at":"2025-03-22T19:33:11.414Z","repository":{"id":41627482,"uuid":"46477612","full_name":"Kovah/CorporateLorem","owner":"Kovah","description":"No more 'Lorem ipsum', get some serious lines from articles for your free text with this generator!","archived":false,"fork":false,"pushed_at":"2024-10-24T09:01:05.000Z","size":1300,"stargazers_count":15,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-25T06:06:56.688Z","etag":null,"topics":["development","golang","lorem-ipsum","placeholder","quotes"],"latest_commit_sha":null,"homepage":"https://corporatelorem.kovah.de","language":"Go","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/Kovah.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2015-11-19T08:10:39.000Z","updated_at":"2024-10-24T09:01:03.000Z","dependencies_parsed_at":"2024-02-28T10:27:11.009Z","dependency_job_id":"70891768-07a7-4537-850f-69d348188ca4","html_url":"https://github.com/Kovah/CorporateLorem","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kovah%2FCorporateLorem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kovah%2FCorporateLorem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kovah%2FCorporateLorem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kovah%2FCorporateLorem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kovah","download_url":"https://codeload.github.com/Kovah/CorporateLorem/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221832466,"owners_count":16888255,"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":["development","golang","lorem-ipsum","placeholder","quotes"],"created_at":"2024-10-15T11:55:48.676Z","updated_at":"2025-03-22T19:33:11.399Z","avatar_url":"https://github.com/Kovah.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eCorporateLorem\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eGet paragraphs of real text ready to copy and paste. No more \"Lorem ipsum dolor\", get some lines from serious articles.\u003c/p\u003e\n\n\u003cp\u003e\u0026nbsp;\u003c/p\u003e\n\n\u003cimg src=\"/preview.png\" alt=\"CorporateLorem Preview\"\u003e\n\n\u003cp\u003e\u0026nbsp;\u003c/p\u003e\n\n\u003e [!NOTE]\n\u003e CorporateLorem is no longer actively maintained, but continues to work and can be used. The app may be upgraded in the future if needed.\n\n\n## About CorporateLorem\n\nCorporateLorem is a small tool that generates Lorem Ipsum paragraphs from real text about different serious topics.\nThe tool contains texts from the New York Times, The Guardian and The Verge across 8 different topics, such as \npolitics, health and science.  \nIt can be used as a command line tool, or can be run as a website that offers both a user interface to generate the\nparagraphs and an API.\n\n\n---\n\n\n## Download CorporateLorem\n\nThe latest version of the tool can be found on the [releases page](https://github.com/Kovah/CorporateLorem/releases).\nPlease download the archive file of the latest release suitable for your operating system. Unpack the zip and make the\nbinary executable.  \nAlternatively, you can use the Docker image. Details about the usage can be found further down.\n\n\n## The command line tool\n\nThe command line tool can be used to quickly generate paragraphs within your terminal or in scripts. It is available\nas the `generate` command and has some optional parameters.\n\n```\ncorporatelorem generate\n```\n\nUsage:  \n  corporatelorem generate [flags]\n\nFlags:  \n  -f, --format string        Format of the returned paragraphs, either json or text (default json)  \n  -h, --help                 help for generate  \n  -n, --number int           Number of paragraphs returned (default 5)  \n  -p, --paragraphs           Show paragraph tags (\u003cp\u003e and \u003c/p\u003e) in the generated paragraphs\n\n\n#### Examples\n\n* `corporatelorem generate` would get you 5 paragraphs in JSON without `\u003cp\u003e` tags\n* `corporatelorem generate -n 15 -p` would get you 15 paragraphs in JSON including the `\u003cp\u003e` tags\n* `corporatelorem generate -n 30 -p -f text` would get you 30 paragraphs as plain text including the `\u003cp\u003e` tags\n* `corporatelorem generate -n 60 -f text` would get you 60 paragraphs as plain text without `\u003cp\u003e` tags\n\n\n---\n\n\n## The website (user interface + API)\n\nThe CorporateLorem executable ships with a built-in web server including all static assets. You can start the web server by\nusing the `serve` command. By default, the started web server listens to port 80 on your host.\n\n```\n$ corporatelorem serve\nStarting HTTP server for CorporateLorem on :80...\n```\n\nYou can now open CorporateLorem in your browser under `http://localhost`.\n\nIf you want to use another port, you can use the optional bind flag. To change the port, specify the port including\npreceding colon. In the following example we tell CorporateLorem to use the port 8090:\n\n```\ncorporatelorem serve -b :8090\n```\n\n\n### Usage of the website API\n\nOnce the web server is started, the CorporateLorem API is available too. In the following examples I assume that you have set\nup CorporateLorem behind a proxy with the domain `your-domain.com` and HTTPS configured.\n\nRequired URL structure:\n`https://your-domain.com/api/[int]`\n\n* The results will be returns as Json by default.\n* The maximum allowed amount of paragraphs is `99`.\n* Append `paragraphs=true` as a query parameter to show paragraph tags in the output.\n* Append `format=text` as a query parameter to get plain text output.\n\n\n#### Examples\n\n* `https://your-domain.com/api/5` would get you 5 paragraphs in JSON without `\u003cp\u003e` tags\n* `https://your-domain.com/api/15?paragraphs=true` would get you 15 paragraphs in JSON including the `\u003cp\u003e` tags\n* `https://your-domain.com/api/30?paragraphs=true\u0026format=text` would get you 30 paragraphs as plain text including the `\u003cp\u003e` tags\n* `https://your-domain.com/api/60?format=text` would get you 60 paragraphs as plain text without `\u003cp\u003e` tags\n\n\n---\n\n\n## The CorporateLorem Docker image\n\nCorporateLorem is also available as a [Docker image](https://hub.docker.com/r/kovah/corporatelorem). It is built using Alpine\nLinux and is less than 10 MB large.\n\nTo use the command line tool, run the Docker image with the `generate` command. More details about the tool can be\nfound in the command line documentation above.\n\n```\ndocker run --rm kovah/corporatelorem generate\n```\n\nTo use the website, you have to additionally forward a port. Please notice that CorporateLorem does not support HTTPS\nconnections, so you probably need a proxy in front of it.  \nYou can start the web server by using the `serve` command. More details about the command can be found in the website \ndocumentation above.\n\n```\ndocker run --rm -p 80:80 kovah/corporatelorem serve\n```\n\n\n---\n\n\n## Contribution\n\nWant to contribute more source texts? Please create a pull request for the new file that should follow the exact same \nstyling like the ones that are already available:\n\n* Filename must contain the name (lowercase, spaces replaced with dashes).\n* The JSON strcuture must match the existing files.\n* Do not use any \u003cp\u003e tags in the paragraphs.\n* Use texts from the already used sources only, or explain why a new source is needed.\n\n\n---\n\n\n## Development and Compilation\n\n### Development\n\nYou need the following packages on your machine to be able to work on CorporateLorem and compile the binary:\n\n* github.com/spf13/cobra\n* github.com/gorilla/mux\n* github.com/GeertJohan/go.rice\n* github.com/GeertJohan/go.rice/rice\n\nThis can be done by running `go mod download` in the current project directory.\n\nTo test the package, compile it and then run the resulting executable. I recommend using Goland\nfor local development. \n\n\n### Compilation\n\nTo compile the binary and run it locally in the same folder, run the following command:\n\n```\nnpm run build-prod\ngo build\n```\n\nTo generate a single binary without any dependencies, you have to generate the needed content file for that:\n```\nrice embed-go\n# then run the build command\ngo build\n```\n\nTo test the current source code, run the following command:\n```\ngo test -run ''\n```\n\n\n---\n\n\nCorporateLorem is a project by [Kovah](https://kovah.de) | [Contributors](https://github.com/Kovah/CorporateLorem/graphs/contributors)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkovah%2Fcorporatelorem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkovah%2Fcorporatelorem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkovah%2Fcorporatelorem/lists"}