{"id":25311514,"url":"https://github.com/xiokka/fering","last_synced_at":"2025-04-07T11:48:36.236Z","repository":{"id":252139859,"uuid":"839540324","full_name":"xiokka/fering","owner":"xiokka","description":"Static webring generator written in Rust.","archived":false,"fork":false,"pushed_at":"2024-08-08T05:43:04.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T14:43:52.433Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xiokka.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2024-08-07T20:26:29.000Z","updated_at":"2024-08-08T05:43:07.000Z","dependencies_parsed_at":"2024-08-07T23:56:43.787Z","dependency_job_id":"29b1d5a9-d43b-4029-a1cf-93c1aed72dc5","html_url":"https://github.com/xiokka/fering","commit_stats":null,"previous_names":["xiokka/fering"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiokka%2Ffering","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiokka%2Ffering/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiokka%2Ffering/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiokka%2Ffering/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xiokka","download_url":"https://codeload.github.com/xiokka/fering/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247648913,"owners_count":20972944,"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":"2025-02-13T14:41:23.071Z","updated_at":"2025-04-07T11:48:36.215Z","avatar_url":"https://github.com/xiokka.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fering\nSimple static webring generator written in Rust.\n\n## Usage\nCreate a new webring.\n```bash\nfering new_webring $webring_name\n```\nExample\n```bash\nfering new_webring \"My new webring\"\n```\nThis will generate some basic project files and directories.\n\nprojectname.txt =\u003e contains project name.\n\nstatic/base.html =\u003e base HTML file that will be used as a template to generate all pages. It contains placeholders which the generator function will replace accordingly.\n\nstatic/about.html =\u003e The $CONTENT of the homepage. This also contains the placeholder $NAVCLOUD, which the generator function will replace with links to each tag index page (each tag index page contains links to all users for that tag).\n\nstatic/style.css =\u003e a rather empty CSS file.\n\nusers/ =\u003e contains users.\n\nimages/ =\u003e contains images.\n\nAdd new user.\n```bash\nfering add_user $username $URL\n```\nExample\n```bash\nfering add_user Xiokka https://xiokka.neocities.org/\n```\nYou must use the full URL. If the $username parameter has whitespaces it must be surrounded by quotation marks\n```bash\nfering add_user \"A really long username\" https://xiokka.neocities.org/\n```\n\nOnce a new user is added, the corresponding subdirectory is created inside the users directory. Inside the new directory, you will find three files: \"tags.txt\", \"description.html\" and \"url.txt\".\ntags.txt contains the tags for that user, where each tag is separated by a whitespace. For example:\n```\nlinux programming command_line\n```\nassigns tags \"linux\", \"programming\" and \"command_line\" to that user.\n\ndescription.html contains HTML which will be inserted into the profile of that user in the webring hub. It can be used as a simple user introduction/profile inside the webring hub.\n\nurl.txt contains the URL for the website of that user.\n\nGenerate site\n```bash\nfering generate\n```\nThis will create the public/ directory, where the webring site has been generated.\n\npublic/users/index.html contains all users in the webring.\n\npublic/$TAG/index.html contains all users tagged with $TAG in their tags.txt file.\n\nEach user has a next.html and previous.html file, which redirect to the next and previous users.\n\n\nTo be redirected to the user next to $USERNAME:\n\npublic/users/$USERNAME/next.html\n\n\nTo be redirected to the user previous to $USERNAME:\n\npublic/users/$USERNAME/previous.html\n\nwhere $USERNAME is a specific member of the webring.\n\n\nFor example, if your webring is hosted on \"https://xiokka.neocities.org/webring/\", you would be redirected to the user next to Xiokka by visiting:\n\nhttps://xiokka.neocities.org/webring/users/Xiokka/next.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiokka%2Ffering","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxiokka%2Ffering","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiokka%2Ffering/lists"}