└── README.org /README.org: -------------------------------------------------------------------------------- 1 | * Justification For Existence Of This Project 2 | 3 | Share links to Emacs initialization files with minimal effort! 4 | 5 | I love reading all kinds of Emacs configuration files ranging for super 6 | refined to just starting out. For example [[https://github.com/caisah/emacs.dz][caisah]] has a list of loads of 7 | stellar examples. However the only way to get added to that list is for your 8 | configuration to be notable. That is a pretty high bar for people just 9 | starting out. New people also usually have the freshest ideas though and they 10 | challenge the status quo of what we currently consider "the best". All of 11 | those perspectives are valuable so I wanted to create a simple list that can 12 | include all of them. 13 | 14 | The only requirement for adding a link here is that you or someone else values 15 | it. A lot or a little no matter how much—someone just needs to have found it 16 | valuable. No shyness or self-consciousness allowed: absolutely add your own! 😄 17 | 18 | Emacs is about sharing and learning and that includes the entire spectrum of 19 | code out there. Happy Hacking! 20 | 21 | * How To Contribute 22 | 23 | - Steps 24 | - Identify Emacs initialization files that either you or someone else found 25 | valuable in some way no matter how large or small. 26 | - Find a link where to get the configuration. That would be a link to the 27 | Git project containing it, the file itself, or a blog post. It is at your 28 | discretion. 29 | - Add that link here. 30 | 31 | * Keep It Simple 32 | 33 | The links are stored as headlines—that way you can store as little or as much 34 | information as you like in whatever way that you want. Add notes, comments, 35 | attribution, and any other classifications of anything. You can apply Org 36 | tags, properties, etc. here. Utilize everything that Org has to offer. Think 37 | of their headline as the most important note to leave for the future reader, 38 | and that includes unforeseen ways that they might want to /use/ the metadata 39 | too! 40 | 41 | * Initialization Files 42 | 43 | ** Aaron Bedra 44 | 45 | [[http://aaronbedra.com/emacs.d/][Aaron Bedra's Emacs 26 Configuration]] 46 | 47 | ** Donald Curtis 48 | 49 | [[https://github.com/milkypostman/dotemacs][Personal .emacs.d directory]] 50 | 51 | ** Grant Rettke 52 | 53 | [[https://github.com/grettke/help][HELP Enables Literate Programming]] 54 | 55 | HELP is the culmination of everything that I've learned about literate 56 | programming (LP) in Org-Mode—written with the intent to share it with others 57 | in total and complete respect and consideration of you and the value of your 58 | time. No platitude here: time /is/ precious. 59 | 60 | With that in mind here is a breakdown of the sections you might be interested 61 | in (and should ignore): 62 | 63 | Here are the files that compose HELP in order of load dependency, the next one 64 | always load the previous one. The first two configuration files are the most 65 | reusable "out of box" parts of HELP: 66 | 67 | - [[https://github.com/grettke/help/blob/master/Org-Mode_Exemple_Complet_Minimal.org][Org-Mode Exemple Complet Minimal]] \rarr [[https://raw.githubusercontent.com/grettke/help/master/.org-mode-ecm.emacs.el][.org-mode-ecm.emacs.el]] 68 | - Proper etiquette before posting questions to the mailing list is to start 69 | Org with nothing else loaded to debug your issue—this is that 70 | configuration. It helps you create the [[https://orgmode.org/worg/org-faq.html#ecm][Org ECM: Exemple Complet Minimal]] 71 | - Helper function to dump all of the information you need to include in the ECM 72 | - By necessity all of the *essential* Emacs configuration, though not much, is 73 | in there too and definitely worth taking a look at 74 | - [[https://github.com/grettke/help/blob/master/Org-Mode_Fundamentals.org][Org-Mode Fundamentals]] \rarr [[https://github.com/grettke/help/blob/master/.org-mode-fundamentals.emacs.el][.org-mode-fundamentals.emacs.el]] 75 | - Org-Mode configuration great for the style of LP described by the table [[https://github.com/grettke/help/blob/master/Org-Mode_Fundamentals.org#literate-programming][here]] 76 | - Individual headlines are good for reference and copy and paste too 77 | - [[https://github.com/grettke/help/blob/master/Package-Management.org][Package-Management.org]] \rarr [[https://github.com/grettke/help/blob/master/.org-mode-package-management.emacs.el][.org-mode-package-management.emacs.el]] 78 | - Package management configuration stuff 79 | - Safe to ignore 80 | - [[https://github.com/grettke/help/blob/master/Contribute.org][Contribute.org]] \rarr [[https://github.com/grettke/help/blob/master/.org-mode-contribute.emacs.el][.org-mode-contribute.emacs.el]] 81 | - Loads packages that for some reason I make changes 82 | - Safe to ignore 83 | - [[https://github.com/grettke/help/blob/master/help.org][help.org]] \rarr [[https://raw.githubusercontent.com/grettke/help/master/.emacs.el][.emacs.el]] 84 | - /The/ section to skim and find parts to copy and paste 85 | - All of my very personal preferences. 86 | - Intent driven headlines that are personal favorites and maybe useful to you 87 | - [[https://github.com/grettke/help/blob/master/help.org#style-guide][LP Style Guide]] 88 | - Writing style guard-rails 89 | - [[https://github.com/grettke/help/blob/master/help.org#history][History]] 90 | - Most of the time you see initialization files that are the result of 91 | years of continuous refinement and improvement—you never see the 92 | complete messes! The fun story about my config include the mistakes, 93 | confusion, and completely dropping Emacs! It is really fond memories 94 | for me, too. 95 | - [[https://github.com/grettke/help/blob/master/help.org#typography][Typography]] 96 | - How to really configure ~fill-column~ (for those who cannot remember) 97 | - [[https://github.com/grettke/help/blob/master/help.org#refile][Refiling]] 98 | - Strategy for moving headlines between files 99 | - [[https://github.com/grettke/help/blob/master/help.org#common-configurations][Common Configurations]] 100 | - Use mode inheritance to simplify configuration 101 | - [[https://github.com/grettke/help/blob/master/help.org#literate-programming][Literate Programming]] 102 | - Every custom configuration of every mode 103 | 104 | ** Magnar Sveen 105 | 106 | [[https://github.com/magnars/.emacs.d][My emacs settings]] 107 | 108 | ** neptune_speed 109 | 110 | [[https://gitgud.io/neptune_speed/init_el/tree/master][Init_El]] 111 | 112 | ** Sacha Chua 113 | 114 | [[http://pages.sachachua.com/.emacs.d/Sacha.html][Sacha Chua's Emacs configuration]] 115 | 116 | ** Steve Purcell 117 | 118 | [[https://github.com/purcell/emacs.d][A reasonable Emacs config]] 119 | 120 | ** Elsa Gonsiorowski 121 | 122 | [[https://github.com/gonsie/dotfiles/tree/master/emacs][My emacs settings]] 123 | This setup includes multiple files from the .emacs and is designed to just work for many versions of Emacs (v23 to current). 124 | 125 | ** Uncle Dave's 126 | [[https://github.com/daedreth/UncleDavesEmacs][UncleDavesEmacs]] Exwm and other good stuff 127 | 128 | ** Yisrael Dov Lebow 129 | 130 | [[https://gitlab.com/yisraeldov/emacs-d][My working .emacs.d]] Using emacs as a desktop environment and PHP ide. I am in the process of redoing the ~init.el~ to be done in orgmode and be cleaner, on branch [[https://gitlab.com/yisraeldov/emacs-d/tree/init-cleanup][init-cleanup]] and documenting the process on [[https://www.youtube.com/playlist?list=PLrFss89N5XNw8rTgI2fVhSj9Y62TpphFI][YouTube]]. 131 | --------------------------------------------------------------------------------