{"id":21458795,"url":"https://github.com/robclancy/f-dotfiles","last_synced_at":"2025-03-17T04:19:45.151Z","repository":{"id":145157925,"uuid":"142069611","full_name":"robclancy/f-dotfiles","owner":"robclancy","description":null,"archived":false,"fork":false,"pushed_at":"2020-07-16T01:02:42.000Z","size":1793,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-15T07:38:09.299Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/robclancy.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":"2018-07-23T21:08:27.000Z","updated_at":"2018-08-08T18:15:52.000Z","dependencies_parsed_at":"2023-07-08T05:15:21.949Z","dependency_job_id":null,"html_url":"https://github.com/robclancy/f-dotfiles","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/robclancy%2Ff-dotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robclancy%2Ff-dotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robclancy%2Ff-dotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robclancy%2Ff-dotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robclancy","download_url":"https://codeload.github.com/robclancy/f-dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243971180,"owners_count":20376784,"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-23T06:24:15.517Z","updated_at":"2025-03-17T04:19:45.131Z","avatar_url":"https://github.com/robclancy.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![F-dotfiles banner](https://raw.githubusercontent.com/Kraymer/bulkdata/master/F-dotfiles/banner.png)\n\n*F-dotfiles is an opiniated dotfiles organization scheme based on stow.   \nHighest priorities are ease of maintenance and deployment on both Linux and OS X.*\n\n- **`stow` powered:** symlink dotfiles and thus keep them always up-to-date in your repository\n- **topical organization:** organize dotfiles by application facilitating reuse across different machines\n- **clever naming scheme:** the repository architecture is easy to browse while staying compatible with `stow` symlinking mechanism\n- **KISS:** there is deliberately none build script involved at all, the repository consist of dotfiles all installable using same modus operandi (`stow \u003cdirectory\u003e`)\n- **documentation:** each package has a *README.md* which present its purpose and a flat `tree` view of its files. Install notes and requirements can also be listed. \n\n## Install\n\n1. clone the repository : `git clone https://github.com/Kraymer/F-dotfiles.git ~/ ; cd ~/F-dotfiles`\n1. setup `stow`, *inception style* : `stow -t ~ stow` \n1. install desired package via `stow \u003cdirectory\u003e` \u003csup id=\"a1\"\u003e[1](#f1)\u003c/sup\u003e\n\nWhen needed, special install instructions are present in package `README.md` file.\n\n## Rules\n\n\u003e *Walter -* That rules really tie the repo together, do they not?  \n\u003e *The Dude -* Fuckin A ! \u003csup id=\"a2\"\u003e[2](#f2)\u003c/sup\u003e\n\n### Directories naming\n\n- lowercase for packages to install in `$HOME` (the default)\n- titlecase for packages to install as root in `/`, eg\n  [`@Daemon-osx`](https://github.com/Kraymer/F-dotfiles/blob/master/attic/@Daemon-osx)\n- leading `@` for environment packages and subpackages, eg\n  [`@mac`](https://github.com/Kraymer/F-dotfiles/blob/master/%40mac/), [`attic/@Daemon-osx`](https://github.com/Kraymer/F-dotfiles/blob/master/attic/@Daemon-osx)\n- leading `_` for non packages, eg [`_homebrew`](https://github.com/Kraymer/F-dotfiles/blob/master/_homebrew) meaning that these directories must not be *stowed*\n\nHaving a convention for subpackage naming enable us to write a [`.stow-global-ignore`](https://github.com/Kraymer/F-dotfiles/blob/master/stow/.stow-global-ignore#L7) file so that subpackages are not symlinked when stowing parent package. \n\n### Ignore files\n\nQuoting stow [documentation](https://www.gnu.org/software/stow/manual/html_node/Installing-Packages.html#Installing-Packages) : \n\n\u003e if Stow can create a single symlink that points to an entire subtree within the package tree, it will choose to do that rather than create a directory in the target tree and populate it with symlinks.\n\n`.gitignore` can be present in packages because of this behaviour, in order to avoid having your repository cluttered with unknown files, see [example](https://github.com/Kraymer/F-dotfiles/blob/master/sublime_text_3/.gitignore).\n\n### Secret files\n\nSecret files, ie files that should not be commited/published, must have *.sec* or */sec/* in their filepath to be ignored by the root `.gitignore` file.\nEach secret file should be accompagnied by an *.example* file that is commited instead, to illustrate the use.\n\nKeep your secret files as short as possible to limit their influence as it complicates deployments (as they cannot be just pulled from github). \n\nSee [example](https://github.com/Kraymer/F-dotfiles/blob/master/%40mac/%40macbook/.config/.gitconfig.sec.example).\n\n### Multi-platforms paths \n\n**Where to save a file that is installed at different locations depending on the OS ?**\n\nThe trick is to have one package per OS, just to create each specific directories structure properly.\nThen create the part of the filepath that is common to the two OS in `\u003cpackage\u003e/_common`, put the files in it, symlink from the subpackages to that location.\n\nFeel confused ? Check [example](https://github.com/Kraymer/F-dotfiles/tree/master/sublime_text_3/%40linux/.config/sublime-text-3)\n\n---\n\u003ci id=\"f1\"\u003e1\u003c/i\u003e it's because we installed `stow` package at step 2 that the flag `-t ~` can be omitted here, see [.stowrc](https://github.com/Kraymer/F-dotfiles/blob/master/stow/.stowrc) [⤸](#a1)  \n\u003ci id=\"f2\"\u003e2\u003c/i\u003e https://www.youtube.com/watch?v=ezQLP1dj_t8 [⤸](#a2)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobclancy%2Ff-dotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobclancy%2Ff-dotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobclancy%2Ff-dotfiles/lists"}