1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
3071
3072
3073
3074
3075
3076
3077
3078
3079
3080
3081
3082
3083
3084
3085
3086
3087
3088
3089
3090
3091
3092
3093
3094
3095
3096
3097
3098
3099
3100
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
3120
3121
3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135
3136
3137
3138
3139
3140
3141
3142
3143
3144
3145
3146
3147
3148
3149
3150
3151
3152
3153
3154
3155
3156
3157
3158
3159
3160
3161
3162
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
3193
3194
3195
3196
3197
3198
3199
3200
3201
3202
3203
3204
3205
3206
3207
3208
3209
3210
3211
3212
3213
3214
3215
3216
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
3251
3252
3253
3254
3255
3256
3257
3258
3259
3260
3261
3262
3263
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3290
3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
3309
3310
3311
3312
3313
3314
3315
3316
3317
3318
3319
3320
3321
3322
3323
3324
3325
3326
3327
3328
3329
3330
3331
3332
3333
3334
3335
3336
3337
3338
3339
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
3357
3358
3359
3360
3361
3362
3363
3364
3365
3366
3367
3368
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
3384
3385
3386
3387
3388
3389
3390
3391
3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
3403
3404
3405
3406
3407
3408
3409
3410
3411
3412
3413
3414
3415
3416
3417
3418
3419
3420
3421
3422
3423
3424
3425
|
#+PROPERTY: header-args:emacs-lisp :tangle tangle/emacs-init.el :results silent
* Overview
** About this document
This files contains all the elisp code normally placed in the .emacs
file. It and the =init.el= file are then symlinked to my =~/.emacs.d/=
directory. Instead of symlinking the files could also be directly
tangled to =~/.emacs.d/=.
#+BEGIN_SRC shell :results silent
ln -sf $(pwd)/emacs-init.org ~/.emacs.d/
ln -sf $(pwd)/tangle/emacs-init.el ~/.emacs.d/
ln -sf $(pwd)/emacs-private.el.gpg ~/.emacs.d/
ln -sf $(pwd)/tangle/init.el ~/.emacs.d/
#+END_SRC
An often seen setup is to use ~org-babel-load-file~ in =init.el= to
load this =.org= configuration file. Instead I chose to auto-tangle
the =.org= file on every save and load the tangled =.el= file
directly. This saves time on startup as tangling does not occur
everytime and also allows for more flexibility regarding tangling file
locations in this configuration file. Namely I can include the content
of =init.el= in this file without problems.
To share this configuration publicly, even though it contains private
information, several solutions are possible. To keep everything in one
file, [[elisp:(find-library "org-crypt")][org-crypt]] is a possible solution. Marking the headings with
private information with the tag =:crypt:= and adding the following to
=init.el= works as a basic setup for =org-crypt=. Also make sure to
disable ~buffer-auto-save-file-name~ for the files.
#+BEGIN_SRC emacs-lisp
(require 'org)
(require 'org-crypt)
(org-crypt-use-before-save-magic)
(setq org-tags-exclude-from-inheritance (quote ("crypt")))
(setq org-crypt-key "F1EF502F9E81D81381B1679AF973BBEA6994521B")
#+END_SRC
I use =.org= configuration files also for my other dotfiles. To ensure
they are tangled upon save I use this function.
#+BEGIN_SRC emacs-lisp
(defun fpi/tangle-dotfiles ()
"If the current file is in '~/.dotfiles' tangle all code blocks."
(when (equal (file-name-directory (directory-file-name buffer-file-name))
(expand-file-name "git/projects/dotfiles/" (getenv "HOME")))
(org-babel-tangle)
(message "%s tangled" buffer-file-name)))
(add-hook 'org-mode-hook (lambda () (add-hook 'before-save-hook #'fpi/tangle-dotfiles nil t)) t)
#+END_SRC
As I use =org-crypt= all =.org= files need to be decrypted before
tangling, saved without encrypting and encrypted after tangling and
saved again. The latter part is not directly supported by =org=.
~org-babel-post-tangle-hook~ is executed in the created tangled files
and not inside the source =.org= file. Instead I add an advice to
~org-babel-tangle~.
#+BEGIN_SRC emacs-lisp
(defun save-without-hook ()
(let ((before-save-hook nil))
(save-buffer)))
(setq org-babel-pre-tangle-hook '(org-decrypt-entries save-without-hook))
;; (setq org-babel-post-tangle-hook '(org-encrypt-entries save-without-hook))
(advice-add 'org-babel-tangle :after '(lambda (&rest r)
(org-encrypt-entries)
(save-without-hook)))
#+END_SRC
Using =org-crypt= unfortunately leads to unusable diffs in =git= for
the encrypted parts. So I tend to only use it for configuration files
which I do not want to split into multiple files. The approach of
using a separate =.el.gpg= or =.org.gpg= file has the same problem.
But =git= can be told to decrypt =.gpg= files before creating the diff
using the following settings (see [[https://magit.vc/manual/magit/How-to-show-diffs-for-gpg_002dencrypted-files_003f.html][here]]).
#+begin_src shell
git config --global diff.gpg.textconv "gpg --no-tty --decrypt"
echo "*.gpg filter=gpg diff=gpg" > .gitattributes
#+end_src
A similar behaviour can be achieved using [[https://github.com/AGWA/git-crypt][git-crypt]]. I save private
details regarding my emacs configuration in =emacs-private.el.gpg= and
load this file here.
#+begin_src emacs-lisp
(setq secret-file (expand-file-name "emacs-private.el.gpg"
user-emacs-directory))
(load secret-file)
#+end_src
This is the content of =init.el=. Notice the ~:tangle tangle/init.el~
header argument in the source code.
#+begin_src emacs-lisp :tangle tangle/init.el
(require 'package)
(package-initialize)
;; (setq safe-local-variable-values (list (cons 'buffer-auto-save-file-name nil)
;; (cons 'header-line-format " ")))
(setq vc-follow-symlinks t)
;; For use on Windows via SSH X-Forwarding
;; See https://emacs.stackexchange.com/a/42440/25850
(setq default-frame-alist
(append default-frame-alist '((inhibit-double-buffering . t))))
(setq posframe-inhibit-double-buffering t)
(load (expand-file-name "emacs-init.el" user-emacs-directory))
#+end_src
I always wanted to reorganize my old init file with >5000 lines, but
never managed to do it completely. So I decided to start from scratch.
The structure and some of the base content is loosely based on the
[[https://gitlab.com/protesilaos/dotemacs/][config of Protesilaos Stavrou]]. Several functions and definitions are
from other configs as well. They are mentioned in the appropriate
places.
Notable configs:
- [[https://gitlab.com/protesilaos/dotemacs/][Protesilaos Stavrou]]
- [[http://doc.rix.si/cce/cce.html][Ryan Rix]]
- [[http://doc.norang.ca/org-mode.html][Bernt Hansen]]
* Base settings
** Setup some paths
#+BEGIN_SRC emacs-lisp
(add-to-list 'load-path "~/.emacs.d/lisp")
(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t)
(add-to-list 'package-archives '("org" . "http://orgmode.org/elpa/") nil)
#+END_SRC
** Meta packages
Packages that don't do anything by themselves, but can be used to help
with other package definition and customization.
*** Use-package
#+begin_src emacs-lisp
(unless (package-installed-p 'use-package)
(package-refresh-contents)
(package-install 'use-package))
(eval-when-compile
(require 'use-package))
#+end_src
*** Hydra
#+begin_src emacs-lisp
(use-package hydra
:ensure t)
#+end_src
This package allows hydra definitions in use-package.
#+begin_src emacs-lisp
(use-package use-package-hydra
:ensure t)
#+end_src
*** which-key
In Emacs you can press =?= or =C-h= after starting a key combination
to get a list of available commands. =which-key= shows these in a
small popup, which I think is more handy.
#+begin_src emacs-lisp
(use-package which-key
:delight
:ensure t
:custom (which-key-idle-delay 0.4)
:config (which-key-mode 1))
#+end_src
*** Try
Sometimes I stumble over a package and want to try it out without
commiting to it and installing it fully – possibly forgetting to
remove it. =Try= installs packages temporarily for this emacs session
only.
#+begin_src emacs-lisp
(use-package try
:ensure t)
#+end_src
** GUI Interface
Disable most of the user interface.
#+BEGIN_SRC emacs-lisp
(use-package emacs
:config
(tooltip-mode -1)
(tool-bar-mode -1)
(menu-bar-mode -1)
(scroll-bar-mode -1)
)
#+END_SRC
In /awesomewm/ and other tiling window managers the emacs window
leaves a gap at the bottom. This removes it.
#+BEGIN_SRC emacs-lisp
(setq frame-resize-pixelwise t)
#+END_SRC
*** Remove mode line clutter
#+begin_src emacs-lisp
(use-package delight
:ensure t
:after use-package)
#+end_src
If removing mode symbols with =delight= is not enough, the mode line
can also be completely removed by setting ~mode-line-format~ to ~nil~.
=hide-mode-line= is a small minor mode that can toggle the mode-line
on and off. I added ~redraw-display~, because i had problems with the
mode-line not being redisplayed, when turning the mode off even though
it calls ~force-mode-line-update~.
#+begin_src emacs-lisp
(use-package hide-mode-line
:ensure t
:hook
(hide-mode-line-mode . redraw-display)
(help-mode . hide-mode-line-mode))
(global-set-key (kbd "C-c m") 'hide-mode-line-mode)
#+end_src
** Font
I am still not quite sure on my choice of font.
=fpi/set-font= is a safe way to choose a font based on
availability. When starting with =emacs --daemon= it does not work as
=(font-family-list)= won't return anything.
#+begin_src emacs-lisp :tangle no
(use-package emacs
:config
(defun fpi/set-font ()
(interactive)
(cond
((member "Hack" (font-family-list)e)
(add-to-list 'default-frame-alist '(font . "Hack-12")))
((member "Source Code Pro" (font-family-list))
(add-to-list 'default-frame-alist '(font . "Source Code Pro-12")))))
(add-to-list 'default-frame-alist '(font . "Hack-12"))
;; :hook (after-init . fpi/set-font)
)
#+end_src
Instead of the above code I set the font directly using
=set-face-attribute=. This is overwritten by my theme settings.
#+begin_src emacs-lisp
(set-face-attribute 'default nil :font "Hack-11")
#+end_src
** Theme & Faces
=hc-zenburn= is the theme I chose for a long time. Lately I started to
appreciate light themes more. [[https://gitlab.com/protesilaos/modus-themes][modus-operandi]] is an interesting light
theme promising high color contrast. I ended up using the
=spacemacs-light= and =spacemacs-dark= themes.
#+begin_src emacs-lisp
(package-install 'spacemacs-theme)
#+end_src
=Face-remap= is a library for basic face remapping. =Buffer-face-mode=
is enabled when using =variable-pitch-mode= to show the face defined
in =variable-pitch= instead of =default=.
#+begin_src emacs-lisp
(use-package face-remap
:delight (buffer-face-mode))
#+end_src
To do some custom adjustments to it I use the following macro which
adds an advice to ~load-theme~.
#+begin_src emacs-lisp
(defmacro set-pair-faces (themes consts faces-alist)
"Macro for pair setting of custom faces.
THEMES name the pair (theme-one theme-two). CONSTS sets the variables like
((sans-font \"Some Sans Font\") ...). FACES-ALIST has the actual faces
like:
((face1 theme-one-attr theme-two-atrr)
(face2 theme-one-attr nil )
(face3 nil theme-two-attr)
...)"
(defmacro get-proper-faces ()
`(let* (,@consts)
(backquote ,faces-alist)))
`(progn
,@(mapcar
(lambda (theme)
`(defadvice load-theme
(after ,(gensym theme) last (loaded-theme &rest args) activate)
(when (equal loaded-theme (quote ,theme))
(custom-theme-set-faces
(quote ,theme) ;; maybe instead use =user= theme?
,@(cl-remove-if
(lambda (x) (equal x "NA"))
(mapcar
(lambda (face)
(let ((face-name (car face))
(face-attrs (nth (cl-position theme themes) (cdr face))))
(if face-attrs
`(quote (,face-name ((t ,face-attrs))))
"NA"))) (get-proper-faces)))
))))
themes)))
#+end_src
The above macro can be used like this.
#+begin_src emacs-lisp
(set-pair-faces
;; Themes to cycle in
(spacemacs-dark spacemacs-light)
;; Variables
((bg-white "#fbf8ef")
(bg-light "#222425")
(bg-dark "#1c1e1f")
(bg-darker "#1c1c1c")
(fg-white "#ffffff")
(shade-white "#efeae9")
(fg-light "#655370")
(dark-cyan "#008b8b")
(region-dark "#2d2e2e")
(region "#39393d")
(slate "#8FA1B3")
(keyword "#f92672")
(comment "#525254")
(builtin "#fd971f")
(purple "#9c91e4")
(doc "#727280")
(type "#66d9ef")
(string "#b6e63e")
(gray-dark "#999")
(gray "#bbb")
(sans-font "Source Sans Pro")
(serif-font "Merriweather")
(et-font "EtBookOt")
(sans-mono-font "Hack")
;; (serif-mono-font "Verily Serif Mono")
(serif-mono-font "cmu typewriter text")
)
;; (set-face-attribute 'default nil :font "Hack-11")
;; (set-face-attribute 'variable-pitch nil :font "EtBookOt-11")
;; Settings
((default
(:family ,sans-mono-font
:background ,bg-dark
:foreground ,bg-white)
(:family ,sans-mono-font
:background ,bg-white
:foreground ,bg-dark))
(variable-pitch
(:family ,sans-font)
(:family ,et-font
:background nil
:foreground ,bg-dark
:height 1.2))
(header-line
(:background nil :inherit nil)
(:background nil :inherit nil))
;; (company-tooltip
;; (:background ,bg-darker
;; :foreground ,gray)
;; nil)
;; (company-scrollbar-fg
;; (:background ,comment)
;; nil)
;; (company-scrollbar-bg
;; (:background ,bg-darker)
;; nil)
;; (company-tooltip-common
;; (:foreground ,keyword)
;; nil)
;; (company-tootip-annotation
;; (:foreground ,type)
;; nil)
;; (company-tooltip-selection
;; (:background ,region)
;; nil)
(show-paren-match
(:background ,keyword
:foreground ,bg-dark)
nil)
(magit-section-heading
(:foreground ,keyword)
nil)
(magit-header-line
(:background nil
:foreground ,bg-dark
:box nil)
(:background nil
:foreground ,bg-white
:box nil))
(magit-diff-hunk-heading
(:background ,comment
:foreground ,gray)
nil)
(magit-diff-hunk-heading-highlight
(:background ,comment
:foreground ,fg-white)
nil)
(tooltip
(:foreground ,gray
:background ,bg-darker)
nil)
(mode-line
(:background ,bg-darker)
(:background ,bg-white
:box nil))
(mode-line-inactive
nil
(:box nil))
(powerline-active1
nil
(:background ,bg-white))
(powerline-active2
nil
(:background ,bg-white))
(powerline-inactive1
nil
(:background ,bg-white))
(powerline-inactive2
nil
(:background ,bg-white))
(highlight
(:background ,region
:foreground ,fg-white)
(:background ,shade-white))
(hl-line
(:background ,region-dark)
nil)
(org-document-title
(:inherit variable-pitch
:height 1.3
:weight normal
:foreground ,gray)
(:inherit nil
:family ,et-font
:height 1.8
:foreground ,bg-dark
:underline nil))
(org-document-info
(:foreground ,gray
:slant italic)
(:height 1.2
:slant italic))
(org-archived
nil
(:inherit shadow
:height 0.6))
(org-level-1
(:inherit variable-pitch
:height 1.3
:weight bold
:foreground ,keyword
:background ,bg-dark)
(:inherit nil
:family ,et-font
:height 1.6
:weight normal
:slant normal
:foreground ,bg-dark))
(org-level-2
(:inherit variable-pitch
:weight bold
:height 1.2
:foreground ,gray
:background ,bg-dark)
(:inherit nil
:family ,et-font
:weight normal
:height 1.3
:slant italic
:foreground ,bg-dark))
(org-level-3
(:inherit variable-pitch
:weight bold
:height 1.1
:foreground ,slate
:background ,bg-dark)
(:inherit nil
:family ,et-font
:weight normal
:slant italic
:height 1.2
:foreground ,bg-dark))
(org-level-4
(:inherit variable-pitch
:weight bold
:height 1.1
:foreground ,slate
:background ,bg-dark)
(:inherit nil
:family ,et-font
:weight normal
:slant italic
:height 1.1
:foreground ,bg-dark))
(org-level-5
(:inherit variable-pitch
:weight bold
:height 1.1
:foreground ,slate
:background ,bg-dark)
nil)
(org-level-6
(:inherit variable-pitch
:weight bold
:height 1.1
:foreground ,slate
:background ,bg-dark)
nil)
(org-level-7
(:inherit variable-pitch
:weight bold
:height 1.1
:foreground ,slate
:background ,bg-dark)
nil)
(org-level-8
(:inherit variable-pitch
:weight bold
:height 1.1
:foreground ,slate
:background ,bg-dark)
nil)
(org-headline-done
(nil)
(:family ,et-font))
(org-quote
(:background ,bg-dark
:family ,sans-mono-font)
nil)
(org-block
(:background ,bg-dark
:family ,sans-mono-font)
(:background nil
:height 0.9
:foreground ,bg-dark
:family ,sans-mono-font))
(org-block-begin-line
(:background ,bg-dark)
(:background nil
:height 0.8
:family ,sans-mono-font
:foreground ,slate))
(org-block-end-line
(:background ,bg-dark)
(:background nil
:height 0.8
:family ,sans-mono-font
:foreground ,slate))
(org-meta-line
(:foreground ,comment)
(:height 0.8
:foreground ,gray))
(org-document-info-keyword
(:foreground ,comment)
(:height 0.8
:foreground ,gray))
(org-link
(:underline nil
:weight normal
:foreground ,slate)
(:foreground ,builtin))
(org-special-keyword
(:height 0.9
:foreground ,comment)
(:family ,sans-mono-font
:height 0.8))
(org-property-value
(:height 0.9
:foreground ,comment)
(:family ,sans-mono-font
:height 0.8))
(org-drawer
(:height 0.9
:foreground ,comment)
(:family ,sans-mono-font
:height 0.8))
(org-todo
(:foreground ,builtin
:background ,bg-dark)
nil)
(org-done
(:inherit variable-pitch
:foreground ,dark-cyan
:background ,bg-dark)
nil)
(org-agenda-current-time
(:foreground ,slate)
nil)
(org-hide
nil
(:foreground ,bg-white))
(org-indent
(:inherit org-hide)
(:inherit (org-hide fixed-pitch)))
(org-time-grid
(:foreground ,comment)
nil)
(org-warning
(:foreground ,builtin)
nil)
(org-date
nil
(:family ,sans-mono-font
:height 0.8))
(org-agenda-structure
(:height 1.3
:foreground ,doc
:weight normal
:inherit variable-pitch)
nil)
(org-agenda-date
(:foreground ,doc)
(:foreground ,doc))
(org-agenda-date-today
(:height 1.5
:foreground ,keyword)
(:height 1.2))
(org-agenda-date-weekend
(:inherit org-agenda-date)
nil)
(org-scheduled
(:foreground ,gray)
nil)
(org-upcoming-deadline
(:foreground ,keyword)
nil)
(org-scheduled-today
(:foreground ,fg-white)
nil)
(org-scheduled-previously
(:foreground ,slate)
nil)
(org-agenda-done
(:inherit nil
:foreground ,doc)
(:foreground ,doc))
(org-ellipsis
(:underline nil
:foreground ,comment)
(:underline nil
:foreground ,comment))
(org-tag
(:foreground ,doc)
(:foreground ,doc))
(org-table
(:background nil
:family ,sans-mono-font)
(:family ,serif-mono-font
:height 0.9
:background ,bg-white))
(org-code
(:inherit font-lock-builtin-face)
(:inherit nil
:family ,serif-mono-font
:foreground ,comment
:height 0.9))
(font-latex-sectioning-0-face
(:foreground ,type
:height 1.2)
nil)
(font-latex-sectioning-1-face
(:foreground ,type
:height 1.1)
nil)
(font-latex-sectioning-2-face
(:foreground ,type
:height 1.1)
nil)
(font-latex-sectioning-3-face
(:foreground ,type
:height 1.0)
nil)
(font-latex-sectioning-4-face
(:foreground ,type
:height 1.0)
nil)
(font-latex-sectioning-5-face
(:foreground ,type
:height 1.0)
nil)
(font-latex-verbatim-face
(:foreground ,builtin)
nil)
(spacemacs-normal-face
(:background ,bg-dark
:foreground ,fg-white)
nil)
(spacemacs-evilified-face
(:background ,bg-dark
:foreground ,fg-white)
nil)
(spacemacs-lisp-face
(:background ,bg-dark
:foreground ,fg-white)
nil)
(spacemacs-emacs-face
(:background ,bg-dark
:foreground ,fg-white)
nil)
(spacemacs-motion-face
(:background ,bg-dark
:foreground ,fg-white)
nil)
(spacemacs-visual-face
(:background ,bg-dark
:foreground ,fg-white)
nil)
(spacemacs-hybrid-face
(:background ,bg-dark
:foreground ,fg-white)
nil)
(bm-persistent-face
(:background ,dark-cyan
:foreground ,fg-white)
nil)
(helm-selection
(:background ,region)
nil)
(helm-match
(:foreground ,keyword)
nil)
(cfw:face-title
(:height 2.0
:inherit variable-pitch
:weight bold
:foreground ,doc)
nil)
(cfw:face-holiday
(:foreground ,builtin)
nil)
(cfw:face-saturday
(:foreground ,doc
:weight bold)
nil)
(cfw:face-sunday
(:foreground ,doc)
nil)
(cfw:face-periods
(:foreground ,dark-cyan)
nil)
(cfw:face-annotation
(:foreground ,doc)
nil)
(cfw:face-select
(:background ,region)
nil)
(cfw:face-toolbar-button-off
(:foreground ,doc)
nil)
(cfw:face-toolbar-button-on
(:foreground ,type
:weight bold)
nil)
(cfw:face-day-title
(:foreground ,doc)
nil)
(cfw:face-default-content
(:foreground ,dark-cyan)
nil)
(cfw:face-disable
(:foreground ,doc)
nil)
(cfw:face-today
(:background ,region
:weight bold)
nil)
(cfw:face-toolbar
(:inherit default)
nil)
(cfw:face-today-title
(:background ,keyword
:foreground ,fg-white)
nil)
(cfw:face-grid
(:foreground ,comment)
nil)
(cfw:face-header
(:foreground ,keyword
:weight bold)
nil)
(cfw:face-default-day
(:foreground ,fg-white)
nil)
(dired-subtree-depth-1-face
(:background nil)
(:background nil))
(dired-subtree-depth-2-face
(:background nil)
(:background nil))
(dired-subtree-depth-3-face
(:background nil)
(:background nil))
(dired-subtree-depth-4-face
(:background nil)
(:background nil))
(dired-subtree-depth-5-face
(:background nil)
(:background nil))
(dired-subtree-depth-6-face
(:background nil)
(:background nil))
(nlinum-current-line
(:foreground ,builtin)
(:foreground ,bg-dark))
(vertical-border
(:background ,region
:foreground ,region)
nil)
(which-key-command-description-face
(:foreground ,type)
nil)
(flycheck-error
(:background nil)
nil)
(flycheck-warning
(:background nil)
nil)
(font-lock-string-face
(:foreground ,string)
nil)
(font-lock-comment-face
(:foreground ,doc
:slant italic)
(:background nil
:foreground ,doc
:slant italic))
(elfeed-search-unread-title-face
(:weight bold)
(:weight bold))
(helm-ff-symlink
(:foreground ,slate)
nil)
(region
(:background ,region)
nil)
(header-line
(:background nil
:inherit nil)
(:background nil
:inherit nil))))
#+end_src
Advice =load-theme= to also update the colors for
=pdf-view-midnight-mode=.
#+begin_src emacs-lisp
(defadvice load-theme (after update-pdf-view-midnight-color activate)
(setq pdf-view-midnight-colors `(,(face-attribute 'default :foreground) . ,(face-attribute 'default :background))))
#+end_src
Finally load the theme.
#+begin_src emacs-lisp
(load-theme 'spacemacs-light t)
#+end_src
** User info
Set ~user-full-name~ and ~user-mail-address~. These are set in
[[file:emacs-private.el.gpg::1][emacs-private.el.gpg]].
#+begin_src emacs-lisp
(setq user-full-name private/user-full-name
user-mail-address private/user-mail-address)
#+end_src
** Desktop module
This saves the state emacs was in.
#+begin_src emacs-lisp
(use-package desktop
:init
(setq desktop-dirname user-emacs-directory)
(setq desktop-base-file-name "desktop")
(setq desktop-globals-to-clear nil)
(setq desktop-missing-file-warning nil)
(setq desktop-restore-eager 5)
(setq desktop-restore-frames nil)
(setq desktop-save 'ask-if-new)
:config
(desktop-save-mode 1))
#+end_src
** Customize
#+BEGIN_SRC emacs-lisp
(use-package cus-edit
:custom
(custom-file (expand-file-name "custom.el" user-emacs-directory))
:hook
(after-init . (lambda ()
(unless (file-exists-p custom-file)
(write-region "" nil custom-file))
(load custom-file))))
#+END_SRC
** File and input history
*** Recentf
#+begin_src emacs-lisp
(use-package recentf
:init
(setq recentf-save-file (expand-file-name "recentf" user-emacs-directory))
(setq recentf-max-menu-items 10)
(setq recentf-max-saved-items 200)
(setq recentf-show-file-shortcuts-flag nil)
:config
(recentf-mode 1))
#+end_src
*** Minibuffer
#+begin_src emacs-lisp
(use-package savehist
:init
(setq savehist-file (expand-file-name "savehist" user-emacs-directory))
(setq history-length 1000)
(setq savehist-save-minibuffer-history t)
:config
(savehist-mode 1))
#+end_src
*** Point
Remember where point is in a file.
#+begin_src emacs-lisp
(use-package saveplace
:init
(setq save-place-file (expand-file-name "saveplace" user-emacs-directory))
:config
(save-place-mode 1))
#+end_src
*** Backups
#+begin_src emacs-lisp
(use-package emacs
:custom
(backup-directory-alist '(("." . "~/.emacs.d/backups")))
(version-control t)
(delete-old-versions t)
(kept-new-versions 6)
(kept-old-versions 2)
(create-lockfiles nil))
#+end_src
** Personal keymap
Unfortunately =C-c [a-z]= is not always a safe place for user-defined
key bindings. I use a special keymap to aggregate common functions. I
rebind the =C-z= binding for this.
*** Toggle map to toggle common options
This was inspired from [[http://endlessparentheses.com/the-toggle-map-and-wizardry.html][this post]] and I bind it to a key on my personal keymap.
#+BEGIN_SRC emacs-lisp :results silent
(define-prefix-command 'fpi/toggle-map)
(define-key fpi/toggle-map "c" #'column-number-mode)
;;(define-key fpi/toggle-map "d" #'toggle-debug-on-error)
(define-key fpi/toggle-map "f" #'auto-fill-mode)
(define-key fpi/toggle-map "l" #'scroll-lock-mode)
(define-key fpi/toggle-map "s" #'flyspell-mode)
(define-key fpi/toggle-map "t" #'toggle-truncate-lines)
(define-key fpi/toggle-map "q" #'toggle-debug-on-quit)
(define-key fpi/toggle-map "r" #'dired-toggle-read-only)
(autoload 'dired-toggle-read-only "dired" nil t)
(define-key fpi/toggle-map "v" #'visible-mode)
(define-key fpi/toggle-map "w" #'whitespace-mode)
(define-key fpi/toggle-map "W" #'whitespace-toggle-options)
#+END_SRC
*** fpi-map
#+BEGIN_SRC emacs-lisp
(define-prefix-command 'fpi-map)
(unbind-key (kbd "C-z"))
(global-set-key (kbd "C-z") 'fpi-map)
;;(define-key fpi-map (kbd "1") 'org-global-cycle)
(define-key fpi-map (kbd "a") 'org-agenda-show-agenda-and-todo)
(define-key fpi-map (kbd "b") 'bury-buffer)
(define-key fpi-map (kbd "c") 'compile)
;;(define-key fpi-map (kbd "u") 'multiple-cursors-hydra/body)
(define-key fpi-map (kbd "e") 'elfeed)
(define-key fpi-map (kbd "h") 'dfeich/context-hydra-launcher)
(define-key fpi-map (kbd "m") 'notmuch)
(define-key fpi-map (kbd "t") fpi/toggle-map)
(define-key fpi-map (kbd "n") 'sauron-toggle-hide-show)
(define-key fpi-map (kbd "j") (lambda () (interactive) (find-file org-journal-file)))
#+END_SRC
** Base commands (simple.el)
#+begin_src emacs-lisp
(use-package simple
:delight (visual-line-mode)
:config
(defun zap-up-to-char (arg char)
"Kill up to and excluding ARGth occurrence of CHAR.
Case is ignored if `case-fold-search' is non-nil in the current buffer.
Goes backward if ARG is negative; error if CHAR not found."
(interactive (list (prefix-numeric-value current-prefix-arg)
(read-char "Zap to char: " t)))
;; Avoid "obsolete" warnings for translation-table-for-input.
(with-no-warnings
(if (char-table-p translation-table-for-input)
(setq char (or (aref translation-table-for-input char) char))))
(kill-region (point) (progn
(search-forward (char-to-string char) nil nil arg)
(if (>= arg 0)
(backward-char)
(forward-char))
(point))))
:bind (:map global-map
("M-z" . zap-up-to-char)))
#+end_src
* Selection and search methods
** Completion frameworks
Having used ido, ivy, icicles and helm in the past, I'm trying to
settle for something simple and go back to ido. The settings below
are for now mostly copied from [[https://gitlab.com/protesilaos/dotemacs/][Protesilaos Stavrou]].
#+BEGIN_SRC emacs-lisp
(use-package ido
:init
(setq ido-everywhere t)
(setq ido-enable-flex-matching t)
(setq ido-enable-regexp nil)
(setq ido-enable-prefix nil)
(setq ido-all-frames nil)
(setq ido-buffer-disable-smart-matches t)
(setq ido-completion-buffer "*Ido Completions*")
(setq ido-completion-buffer-all-completions nil)
(setq ido-confirm-unique-completion nil)
(setq ido-create-new-buffer 'prompt)
(setq ido-default-buffer-method 'selected-window)
(setq ido-default-file-method 'selected-window)
(setq ido-enable-last-directory-history t)
(setq ido-use-filename-at-point nil)
(setq ido-use-url-at-point nil)
(setq ido-use-virtual-buffers t)
(setq ido-use-faces t)
(setq ido-max-window-height 1)
(setq ido-decorations
'(" "
" "
" | "
" | …"
"["
"]"
" [No match]"
" [Matched]"
" [Not readable]"
" [Too big]"
" [Confirm]"
" "
" "))
(setq ido-auto-merge-work-directories-length -1)
:config
(ido-mode 1)
:hook
(minibuffer-setup . (lambda ()
(visual-line-mode 1)
(setq-local truncate-lines nil)
(setq-local resize-mini-windows nil)
(setq-local max-mini-window-height 1))))
#+END_SRC
#+BEGIN_SRC emacs-lisp
(use-package ido-completing-read+
:ensure t
:after ido
:config
(ido-ubiquitous-mode 1))
#+END_SRC
*** amx
Ido completion for =M-x=.
#+BEGIN_SRC emacs-lisp :tangle no
(use-package amx
:ensure t
:after (ido ido-completing-read+)
:init
(setq amx-backend 'ido)
(setq amx-save-file "~/.emacs.d/amx-items")
(setq amx-history-length 10)
(setq amx-show-key-bindings nil)
:config
(amx-mode 1))
#+END_SRC
** isearch enhancements
Once again this is mostly taken from [[https://gitlab.com/protesilaos/dotemacs/][Protesilaos Stavrou]].
#+BEGIN_SRC emacs-lisp
(use-package isearch
:init
(setq search-whitespace-regexp ".*")
;; Or use the following for non-greedy matches
;; (setq search-whitespace-regexp ".*?")
(setq isearch-lax-whitespace t)
(setq isearch-regexp-lax-whitespace nil)
:config
(defun prot/isearch-mark-and-exit ()
"Marks the current search string. Can be used as a building
block for a more complex chain, such as to kill a region, or
place multiple cursors."
(interactive)
(push-mark isearch-other-end t 'activate)
(setq deactivate-mark nil)
(isearch-done))
(defun stribb/isearch-region (&optional not-regexp no-recursive-edit)
"If a region is active, make this the isearch default search
pattern."
(interactive "P\np")
(when (use-region-p)
(let ((search (buffer-substring-no-properties
(region-beginning)
(region-end))))
(message "stribb/ir: %s %d %d" search (region-beginning) (region-end))
(setq deactivate-mark t)
(isearch-yank-string search))))
(advice-add 'isearch-forward-regexp :after 'stribb/isearch-region)
(advice-add 'isearch-forward :after 'stribb/isearch-region)
(advice-add 'isearch-backward-regexp :after 'stribb/isearch-region)
(advice-add 'isearch-backward :after 'stribb/isearch-region)
(defun contrib/isearchp-remove-failed-part-or-last-char ()
"Remove failed part of search string, or last char if successful.
Do nothing if search string is empty to start with."
(interactive)
(if (equal isearch-string "")
(isearch-update)
(if isearch-success
(isearch-delete-char)
(while (isearch-fail-pos) (isearch-pop-state)))
(isearch-update)))
(defun contrib/isearch-done-opposite-end (&optional nopush edit)
"End current search in the opposite side of the match.
Particularly useful when the match does not fall within the
confines of word boundaries (e.g. multiple words)."
(interactive)
(funcall #'isearch-done nopush edit)
(when isearch-other-end (goto-char isearch-other-end)))
:bind (:map isearch-mode-map
("C-SPC" . prot/isearch-mark-and-exit)
("DEL" . contrib/isearchp-remove-failed-part-or-last-char)
("<C-return>" . contrib/isearch-done-opposite-end)))
#+END_SRC
* Directory, project, buffer, window management
** Dired
*** Base settings
- Always do recursive copies and deletions.
- Be smart about searching file names or the whole buffer.
- Use the system trash for now.
- Customize dired output switches.
- Dont try to be smart about rename and copy target locations when
having two open dired buffers. Setting the target to the other
directory is just as easy using =M-n= twice.
- Hide details by default. =(= to toggle.
- Highlight current line.
- Let the relevant =find= commands use case-insensitive names.
- Enable asynchronous mode for copying/renaming.
#+BEGIN_SRC emacs-lisp
(use-package dired
:custom
(dired-recursive-copies 'always)
(dired-recursive-deletes 'always)
(dired-isearch-filenames 'dwim)
(delete-by-moving-to-trash t)
(dired-listing-switches "-AFlh --group-directories-first")
(dired-dwim-target nil)
:hook
(dired-mode . dired-hide-details-mode)
(dired-mode . hl-line-mode)
(dired-mode . auto-revert-mode))
(use-package find-dired
:after dired
:custom
(find-ls-option ;; applies to `find-name-dired'
'("-ls" . "-AFlv --group-directories-first"))
(find-name-arg "-iname"))
(use-package async
:ensure t)
(use-package dired-async
:after (dired async)
:config
(dired-async-mode 1))
#+END_SRC
*** Narrowing
#+BEGIN_SRC emacs-lisp
(use-package dired-narrow
:ensure t
:after dired
:bind (:map dired-mode-map
("SPC" . dired-narrow-regexp)))
#+END_SRC
*** wdired
Start with =C-x C-q=.
- Allow to change permissions.
- Interpret forward slash in renamed files as new subdirectory to
create.
#+BEGIN_SRC emacs-lisp
(use-package wdired
:after dired
:init
(setq wdired-allow-to-change-permissions t)
(setq wdired-create-parent-directories t))
#+END_SRC
*** peep-dired (file previews including images)
By default, dired does not show previews of files, while =image-dired=
is intended for a different purpose. We just want to toggle the
behaviour while inside a regular dired buffer.
#+BEGIN_SRC emacs-lisp
(use-package peep-dired
:ensure t
:after dired
:bind (:map dired-mode-map
("P" . peep-dired))
:custom
(peep-dired-cleanup-on-disable t)
(peep-dired-ignored-extensions
'("mkv" "webm" "mp4" "mp3" "ogg" "iso")))
#+END_SRC
*** dired-x
Some additional features that are shipped with Emacs.
#+BEGIN_SRC emacs-lisp
(use-package dired-x
:after dired
:bind (("C-x C-j" . dired-jump)
("C-x 4 C-j" . dired-jump-other-window))
:hook
(dired-mode . (lambda ()
(setq dired-clean-confirm-killing-deleted-buffers t))))
#+END_SRC
*** dired-subtree
+ The tab key will expand or contract the subdirectory at point.
+ =C-TAB= will behave just like org-mode handles its headings: hit it
once to expand a subdir at point, twice to do it recursively, thrice
to contract the tree.
+ I also have Shift-TAB for contracting the subtree /when the point is
inside of it/.
At any rate, this does not override the action of inserting a
subdirectory listing in the current dired buffer (with =i= over the
target dir).
#+BEGIN_SRC emacs-lisp
(use-package dired-subtree
:ensure t
:after dired
:bind (:map dired-mode-map
("<tab>" . dired-subtree-toggle)
("<C-tab>" . dired-subtree-cycle)
("<S-iso-lefttab>" . dired-subtree-remove)))
#+END_SRC
*** dired-sidebar
Open a small sidebar window showing the current directory.
#+BEGIN_SRC emacs-lisp
(use-package dired-sidebar
:bind (("C-x C-n" . dired-sidebar-toggle-sidebar))
:ensure t
:commands (dired-sidebar-toggle-sidebar)
:hook
(dired-sidebar-mode . (lambda ()
(unless (file-remote-p default-directory)
(auto-revert-mode))))
:config
;; (setq dired-sidebar-theme 'vscode)
(setq dired-sidebar-use-term-integration t))
#+END_SRC
*** dired-du
Recursive directory sizes. Toggle with =C-x M-r=. This will take a
while for directories with lots of nested files.
#+BEGIN_SRC emacs-lisp
(use-package dired-du
:ensure t
:config (setq dired-du-size-format 't))
#+END_SRC
** Tramp
Set Tramp to prefer the path settings in =~/.profile= over the value
of src_shell{getconf "PATH"}. See [[elisp:(describe-variable
'tramp-remote-path)]] for more info.
#+begin_src emacs-lisp
(use-package tramp
:config
(add-to-list 'tramp-remote-path 'tramp-own-remote-path))
#+end_src
** Git
*** Magit
#+BEGIN_SRC emacs-lisp
(use-package magit
:ensure t
:custom (magit-completing-read-function 'magit-ido-completing-read)
:init (global-magit-file-mode))
#+END_SRC
The following package is configured in accordance with the guidelines
provided by this article on [[https://chris.beams.io/posts/git-commit/][writing a Git commit message]].
#+BEGIN_SRC emacs-lisp
(use-package git-commit
:after magit
:custom
(git-commit-fill-column 72)
(git-commit-summary-max-length 50)
(git-commit-known-pseudo-headers
'("Signed-off-by"
"Acked-by"
"Modified-by"
"Cc"
"Suggested-by"
"Reported-by"
"Tested-by"
"Reviewed-by"))
(git-commit-style-convention-checks
'(non-empty-second-line
overlong-summary-line)))
#+END_SRC
Only highlight the changes within a line, not the whole line.
#+BEGIN_SRC emacs-lisp
(use-package magit-diff
:after magit
:custom
(magit-diff-refine-hunk 'all))
#+END_SRC
**** gitflow
Add support for [[https://nvie.com/posts/a-successful-git-branching-model/][gitflow]].
#+begin_src emacs-lisp
(use-package magit-gitflow
:ensure t
:hook (magit-mode . turn-on-magit-gitflow))
#+end_src
*** diff-hl
Indicates changed lines in the left fringe. The Hydra can be used to
navigate and revert hunks directly from the buffer. Use =g= to open
=magit-status=. I also bind this hydra to =g= in my personal keymap.
#+begin_src emacs-lisp
(use-package diff-hl
:ensure t
:defer t
:bind (:map fpi-map ("g" . hydra-diff-hl/body))
:init (global-diff-hl-mode 1)
:config (defhydra hydra-diff-hl (:body-pre (diff-hl-mode 1)
:hint nil)
"
Diff-hl:
_n_: next hunk _s_tage hunk _g_: Magit status
_p_: previous hunk _r_evert hunk _q_uit
^ ^ _P_opup hunk _Q_uit and deactivate git-gutter
_a_: first hunk
_e_: last hunk _A_mend mode
"
("n" diff-hl-next-hunk)
("p" diff-hl-previous-hunk)
("a" (progn (goto-char (point-min))
(diff-hl-next-hunk)))
("e" (progn (goto-char (point-max))
(diff-hl-previous-hunk)))
("s" git-gutter:stage-hunk)
("r" diff-hl-revert-hunk)
("P" diff-hl-diff-goto-hunk)
("A" diff-hl-amend-mode)
("g" magit-status :color blue)
("q" nil :color blue)
("Q" (diff-hl-mode -1)
:color blue))
)
#+end_src
*** git-auto-commit
Mode to automatically commit on file save. Ensure that automatic
pushing is always turned off. To enable this with [[info:emacs#File Variables][File Variables]] set
some safe local variable values.
#+begin_src emacs-lisp
(use-package git-auto-commit-mode
:delight
:ensure t
:custom
(gac-automatically-push-p nil)
:config
(add-to-list 'safe-local-variable-values
'(eval add-hook
(quote after-save-hook)
(quote gac-after-save-func)
t t))
(add-to-list 'safe-local-variable-values
'(git-auto-commit-mode . t)))
#+end_src
** Projectile
#+BEGIN_SRC emacs-lisp
(use-package projectile
:ensure t
:delight '(:eval (concat " " (projectile-project-name)))
:init
(setq projectile-project-search-path '("~/git/projects/"))
(setq projectile-indexing-method 'alien)
(setq projectile-enable-caching t)
(setq projectile-completion-system 'ido)
:config
(projectile-mode 1)
:bind (("C-c p" . projectile-command-map)))
#+END_SRC
** Working with buffers
This renames buffers with the same name and uniqifies them using angled
brackets containing their path.
#+BEGIN_SRC emacs-lisp
(use-package uniquify
:custom
(uniquify-buffer-name-style 'forward)
(uniquify-strip-common-suffix t)
(uniquify-after-kill-buffer-p t))
#+END_SRC
#+begin_src emacs-lisp
(use-package autorevert
:delight (auto-revert-mode))
#+end_src
*** ibuffer
#+BEGIN_SRC emacs-lisp
(use-package ibuffer
:custom
(ibuffer-display-summary nil)
(ibuffer-use-other-window nil)
(ibuffer-auto-mode -1)
:hook
(ibuffer-mode . ibuffer-auto-mode))
#+END_SRC
Sort buffers in project groups using projectile.
#+BEGIN_SRC emacs-lisp :tangle no
(use-package ibuffer-projectile
:ensure t
:after (ibuffer projectile)
:hook
(ibuffer-mode . (lambda ()
(ibuffer-projectile-set-filter-groups)
(unless (eq ibuffer-sorting-mode 'recency)
(ibuffer-do-sort-by-recency)))))
#+END_SRC
=ibuffer-projectile= updates can be fairly slow. =ibuffer-vc= provides
better performance.
#+begin_src emacs-lisp
(use-package ibuffer-vc
:ensure t
:custom
(ibuffer-formats
'((mark modified read-only vc-status-mini " "
(name 18 18 :left :elide)
" "
(size 9 -1 :right)
" "
(mode 16 16 :left :elide)
" "
(vc-status 16 16 :left)
" "
vc-relative-file)))
:hook
(ibuffer . (lambda ()
(ibuffer-vc-set-filter-groups-by-vc-root)
(unless (eq ibuffer-sorting-mode 'alphabetic)
(ibuffer-do-sort-by-alphabetic)))))
#+end_src
** Window configuration
=fit-window-to-buffer= automatically shrinks the current buffer based
on the amount of displayed text.
#+begin_src emacs-lisp
(use-package window
:custom
(fit-window-to-buffer-horizontally t)
:bind (:map fpi-map ("s" . fit-window-to-buffer)))
#+end_src
*** Window rules
#+begin_src emacs-lisp
(use-package window
:init
(setq display-buffer-alist
'(
("\\*\\(Backtrace\\|Warnings\\|Compile-Log\\|Messages\\)\\*"
(display-buffer-in-side-window)
(window-height . 0.16)
(side . top)
(slot . 0)
(window-parameters . ((no-other-window t))))
(".*\\*Completions.*"
(display-buffer-in-side-window)
(window-height . 0.16)
(side . bottom)
(slot . 0))
("\\*Help.*"
(display-buffer-in-side-window)
(window-width . 0.2)
(side . left)
(slot . 0)
(window-parameters . ((no-other-window . t)
(mode-line-format . (" "
mode-line-buffer-identification)))))
)))
#+end_src
*** window-numbering
This is a nice package for easy window focus switching. I prefer it
over =windmove=, as it does not interfere with org keybindings.
#+begin_src emacs-lisp
(use-package window-numbering
:ensure t
:config (window-numbering-mode 1))
#+end_src
*** Winner-mode
#+begin_src emacs-lisp
(use-package winner
:hook (after-init . winner-mode)
:hydra (winner-hydra
(global-map "C-c" :color red)
"Winner undo/redo"
("<left>" winner-undo "undo")
("<right>" winner-redo "redo"))
:bind (:map winner-mode-map
("C-c <left>" . winner-hydra/winner-undo)
("C-c <right>" . winner-hydra/winner-redo)))
#+end_src
* Applications and utilities
** Calendar
Some basic calendar options for date format und location to provide
correct sunrise/-set times.
#+begin_src emacs-lisp
(use-package calendar
:custom
(calendar-date-style 'european)
(calendar-latitude 52.3667)
(calendar-longitude 9.7167))
#+end_src
Set the holidays to consider. I only use german and christian
holidays. Note the =:init= keyword. The individual holiday lists have
to be set before =holidays= is loaded and ~calendar-holidays~ is
initialized.
#+begin_src emacs-lisp
(use-package holidays
:init
(setq holiday-bahai-holidays nil
holiday-christian-holidays
(quote
((holiday-float 12 0 -4 "1. Advent" 24)
(holiday-float 12 0 -3 "2. Advent" 24)
(holiday-float 12 0 -2 "3. Advent" 24)
(holiday-float 12 0 -1 "4. Advent" 24)
(holiday-fixed 12 25 "1. Weihnachtstag")
(holiday-fixed 12 26 "2. Weihnachtstag")
(holiday-fixed 1 6 "Heilige Drei Könige")
(holiday-easter-etc -48 "Rosenmontag")
(holiday-easter-etc -2 "Karfreitag")
(holiday-easter-etc 0 "Ostersonntag")
(holiday-easter-etc 1 "Ostermontag")
(holiday-easter-etc 39 "Christi Himmelfahrt")
(holiday-easter-etc 49 "Pfingstsonntag")
(holiday-easter-etc 50 "Pfingstmontag")
(holiday-easter-etc 60 "Fronleichnam")
(holiday-fixed 8 15 "Mariae Himmelfahrt")
(holiday-fixed 11 1 "Allerheiligen")
(holiday-float 11 0 1 "Totensonntag" 20)))
holiday-general-holidays
(quote
((holiday-fixed 1 1 "Neujahr")
(holiday-fixed 2 14 "Valentinstag")
(holiday-fixed 5 1 "1. Mai")
(holiday-float 5 0 2 "Muttertag")
(holiday-fixed 10 3 "Tag der Deutschen Einheit")))
holiday-hebrew-holidays nil
holiday-islamic-holidays nil
holiday-oriental-holidays nil))
(use-package solar
:custom
(solar-n-hemi-seasons '("Frühlingsanfang" "Sommeranfang" "Herbstanfang" "Winteranfang")))
#+end_src
** PDFs
=PDF-Tools= provides better rendering than =DocView=, which is only
png based. It also provides pdf syncing with a tex source. To use this
make sure to compile the tex document with the option ~--synctex=1~.
#+BEGIN_SRC emacs-lisp
(use-package pdf-tools
:ensure t
:config
(setq pdf-info-epdfinfo-program (concat user-emacs-directory "epdfinfo"))
(pdf-tools-install))
#+END_SRC
Add support for pdf annotations. Rebind ~pdf-annot-minor-mode-map~ to
an easier prefix and undefine the bindings of ~image-mode~ for this
prefix. For now they are unbound globally as I never use them. It
would be better to unbind them only when in ~pdf-view-mode~.
#+BEGIN_SRC emacs-lisp
(use-package image-mode
:config
(define-key image-mode-map "a+" nil)
(define-key image-mode-map "a-" nil)
(define-key image-mode-map "a0" nil)
(define-key image-mode-map "ar" nil))
(use-package pdf-annot
:init (setq pdf-annot-minor-mode-map-prefix "a")
:bind (:map pdf-annot-minor-mode-map ("a d" . pdf-annot-delete)))
#+END_SRC
** Latex
#+begin_src emacs-lisp
(use-package auctex
:ensure t)
#+end_src
=cdlatex= depends on =texmath.el=. The docstring of =cdlatex= says
=texmath= is supposed to be part of Emacs. However my installation
does not have it. So =auctex= has to deliver this dependency instead.
#+begin_src emacs-lisp
(use-package cdlatex
:ensure t
:custom
(cdlatex-env-alist
(list '("equation*" "\\begin{equation*}\nAUTOLABEL\n?\n\\end{equation*}" nil)
'("tikzpicture" "\\begin{tikzpicture}\nAUTOLABEL\n?\n\\end{tikzpicture}" nil)
'("circuitikz" "\\begin{circuitikz}\nAUTOLABEL\n?\n\\end{circuitikz}" nil))))
#+end_src
** Programming languages
*** Emacs lisp
=Speed of thought= makes writing lisp so easy. No more snippets
needed.
#+begin_src emacs-lisp
(use-package sotlisp
:ensure t
:init
(add-hook 'emacs-lisp-mode-hook 'speed-of-thought-mode))
#+end_src
=Eldoc= displays information on variables and functions in the echo
area.
#+begin_src emacs-lisp
(use-package eldoc
:delight)
#+end_src
** Org mode
Org is the mode you never need to leave, if you do not want to. My org
TODO and clocking setup is largely inspired by [[http://doc.rix.si/cce/cce-org.html][Ryan Rix's]] and [[http://doc.norang.ca/org-mode.html][Bernt
Hansen's]] configs.
- Scale latex previews :: The default is just a little bit too
small
- org-plus-contrib :: Install the =org-plus-contrib= package which
contains many extra org-modules.
- Startup indented :: Enable =org-indent-mode= in every org file. This
shows the content of headings indented to the headings level, but
does not actually insert whitespace at the start of the line.
- Enable Speed commands :: With the custom function speed commands are
enabled on any star of an headline.
- Set fast tag selection :: By defining default tags they can be set
just with one key press, similar to TODO states.
- Code blocks :: Open code blocks in the current window and use native
settings for the code blocks.
- Custom link abbrevs :: Define any expansion and use them as normal
org links like [[ddg:emacs]].
- Babel languages :: Enable more languages to use in org-babel blocks.
- Youtube links :: See [[http://endlessparentheses.com/embedding-youtube-videos-with-org-mode-links.html][this blog post]] for more info.
- Ellipsis :: I currently use =" "= and previously used ="⚡⚡⚡"=.
- Refile Targets :: Use the full outline path so I can distinguish
headlines with the same name & disable step-wise completion as I
think from the refile target backwards, not from top-level
downwards.
- Drawer for Notes :: Notes go into the =NOTES= drawer. Clocking
times should stay separate in the =LOGBOOK= drawer.
- Track state changes :: Notes when an entry is switched to done when
the deadline or scheduled time change
- TODO Keywords :: Set my todo keywords, enable fast selection & some
custom faces for the todo keywords
- Change todo state on clock-in :: Switch entries automatically from
NEXT to INPROGRESS
- Align tags left :: Fixes problems with line breaking on small
window width.
- Inline image width :: Resize images to 400px but respect width
specifications in attribute lines.
#+begin_src emacs-lisp
(use-package org
:ensure org-plus-contrib
:delight (org-cdlatex-mode)
:defer t
:bind
(("C-c c" . org-capture)
("C-c a" . org-agenda)
("C-c l" . org-store-link))
:custom
(org-format-latex-options '(:foreground default :background default :scale 1.5 :html-foreground "Black" :html-background "Transparent" :html-scale 1.0 :matchers
("begin" "$1" "$" "$$" "\\(" "\\[")))
(org-catch-invisible-edits 'smart)
(org-agenda-diary-file "~/sync/diary.org")
(org-use-speed-commands (lambda () (and (looking-at org-outline-regexp) (looking-back "^\**"))))
(org-pretty-entities t)
(org-fast-tag-selection-single-key t)
(org-tag-alist (quote ((:startgroup)
("@errand" . ?e)
("@office" . ?o)
("@home" . ?H)
(:endgroup)
("IDLE" . ?i)
("shelf" . ?s)
("soon" . ?t)
("project" . ?p)
;; ("HOLD" . ?h)
;; ("PERSONAL" . ?P)
("WORK" . ?W)
;; ("ORG" . ?O)
("crypt" . ?E)
("NOTE" . ?n)
;; ("CANCELLED" . ?c)
("FLAGGED" . ??)
)))
(org-link-abbrev-alist
'(("google" . "http://www.google.com/search?q=")
("ddg" . "https://duckduckgo.com/?q=")
("gmap" . "http://maps.google.com/maps?q=%s")
("omap" . "http://nominatim.openstreetmap.org/search?q=%s&polygon=1")))
(org-ellipsis " ")
(org-refile-use-outline-path 'file)
(org-outline-path-complete-in-steps nil)
(org-log-state-notes-into-drawer "NOTES")
(org-clock-into-drawer "LOGBOOK")
(org-log-done 'time)
(org-log-redeadline 'time)
(org-log-reschedule 'time)
(org-todo-keywords '((sequence "PLANNING(p)" "NEXT(n)" "INPROGRESS(i!)" "WAITING(w@/!)" "|" "ICEBOX(x@)" "DONE(d)")
(sequence "S(s)" "DONE(d)")
(sequence "PHONE(P)" "MEETING(m)" "|" "CANCELLED(c)")
(sequence "TODO(t)" "|" "DONE(d)")
(sequence "IDLE(a)")))
(org-use-fast-todo-selection t)
(org-todo-keyword-faces
'(("NEXT" :foreground "light blue" :weight bold)
("INPROGRESS" :foreground "burlywood" :weight bold)
("DONE" :foreground "forest green" :weight bold)
("WAITING" :foreground "orange" :weight bold)
("ICEBOX" :foreground "orange" :weight normal)
("CANCELLED" :foreground "forest green" :weight bold)
("MEETING" :foreground "yellow" :weight bold)
("PHONE" :foreground "yellow" :weight bold)
("IDLE" :foreground "magenta" :weight bold)))
(org-clock-in-switch-to-state 'bh/clock-in-to-inprogress)
(org-tags-column 0)
(org-image-actual-width '(400))
:config
(add-hook 'org-mode-hook 'turn-on-org-cdlatex)
(add-to-list 'org-structure-template-alist (cons "f" "figure"))
(add-to-list 'org-tags-exclude-from-inheritance "MARKED")
(defun bh/clock-in-to-inprogress (kw)
"Switch a task from NEXT to INPROGRESS when clocking in.
Skips capture tasks, projects, and subprojects.
Switch projects and subprojects from NEXT back to TODO"
(when (not (and (boundp 'org-capture-mode) org-capture-mode))
(cond
((and (member (org-get-todo-state) (list "NEXT"))
(bh/is-task-p))
"INPROGRESS")
((and (member (org-get-todo-state) (list "NEXT"))
(bh/is-project-p))
"INPROGRESS")))))
#+end_src
#+begin_src emacs-lisp
(use-package org-indent
:delight
:custom
(org-startup-indented t))
#+end_src
#+begin_src emacs-lisp
(use-package ob
:config (org-babel-do-load-languages
'org-babel-load-languages
'((ruby . t)
(python . t)
;;(ipython . t)
(emacs-lisp . t)
(octave . t)
(gnuplot . t)
(dot . t)
(spice . t)
(C . t)
(calc . t)
(latex . t)
(matlab . t)
(shell . t)
(lua . t)
(org . t)
(js . t)
(ditaa . t)
(plantuml . t)
;; (hvm . t)
(ledger . t)))
:hook (org-babel-after-execute . org-display-inline-images))
#+end_src
#+BEGIN_SRC emacs-lisp
(use-package org-noter
:ensure t
:bind (:map org-mode-map ("C-c o" . org-noter))
:custom (org-noter-default-notes-file-names '("notes.org"))
)
#+END_SRC
#+begin_src emacs-lisp
(use-package ox
:custom
(org-export-with-broken-links 'match)
(org-export-backends '(ascii beamer html icalendar latex man md odt org groff koma-letter)))
(use-package org-pdfview
:ensure t)
(use-package org-id
:custom (org-id-link-to-org-use-id 'create-if-interactive-and-no-custom-id))
(use-package org-clock
:custom
(org-clock-out-remove-zero-time-clocks t)
(org-clock-persist 'history)
(org-clock-history-length 30)
:init
(org-clock-persistence-insinuate)
)
(use-package org-src
:custom
(org-src-window-setup 'current-window)
(org-src-fontify-natively t)
(org-src-tab-acts-natively t)
(org-edit-src-content-indentation 0)
)
(use-package org-agenda
:custom
(org-agenda-files (quote ("~/s/s.org" "~/sync" "~/.emacs.d/gcal.org" "~/.emacs.d/tr.org" "~/n.org")))
(org-deadline-warning-days 14)
(org-agenda-start-on-weekday nil)
(org-agenda-span 14)
(org-agenda-start-day "+0d")
(org-agenda-include-diary nil)
(org-agenda-sticky t)
(org-agenda-todo-ignore-deadlines 'near) ;; or future?
(org-agenda-todo-ignore-scheduled 'future)
(org-agenda-skip-deadline-prewarning-if-scheduled t)
(org-agenda-tags-todo-honor-ignore-options t)
(org-agenda-todo-list-sublevels t) ;; nil to exclude sublevels of todos
(org-agenda-sorting-strategy '((agenda habit-down time-up priority-down category-keep)
(todo priority-down category-keep)
(tags priority-down category-keep)
(search category-keep)))
(org-agenda-skip-scheduled-if-done t)
(org-agenda-dim-blocked-tasks t)
(org-sort-agenda-notime-is-late t)
;; See emacs.christianbaeuerlein.com/my-org-config.html
(org-agenda-block-separator 9472)
(org-agenda-custom-commands
'(("n" "Agenda and all TODOs"
((todo "INPROGRESS"
((org-agenda-overriding-header "Inprogress Tasks")))
(agenda)
(tags-todo "+soon+LEVEL=2"
((org-agenda-overriding-header "2nd Level /Soon/ Tasks")))
(tags-todo "+soon"
((org-agenda-overriding-header "All /Soon/ Tasks")))
(tags-todo "+shelve")
(tags-todo "+habit")
(todo "IDLE")
(tags-todo "-habit-shelve-soon-idle")))
("r" "Refile entries" ((tags "+REFILE")))
("i" "Idle Actions"
((tags-todo "IDLE-READLIST-WATCH"
((org-agenda-overriding-header "Idle Tasks")
(org-agenda-skip-function 'bh/skip-project-tasks)
(org-agenda-sorting-strategy
'(todo-state-down effort-up))))
(tags-todo "READLIST"
((org-agenda-overriding-header "Idle Reading List")
(org-agenda-sorting-strategy
'(todo-state-down effort-up))))
(tags-todo "WATCH"
((org-agenda-overriding-header "Things to Watch")
(org-agenda-skip-function 'bh/skip-project-tasks)
(org-agenda-sorting-strategy
'(todo-state-down effort-up))))))))
)
(use-package ob-core
:custom
(org-confirm-babel-evaluate nil))
(use-package org-screenshot)
(use-package org-collector)
(use-package ox)
(use-package org-notmuch)
(use-package org-expiry
:custom
(org-expiry-handler-function 'org-expiry-archive-subtree))
(use-package org-habit)
#+end_src
#+begin_src emacs-lisp
(use-package org-inlinetask)
#+end_src
=org-bullets= provides better headline bullets.
Here is a list of nice ones: ◉, ○, ►, •. The default ones are ~'("◉" "○" "✸" "✿")~.
#+begin_src emacs-lisp
(use-package org-bullets
:ensure t
:custom (org-bullets-bullet-list '("✧"))
:config (add-hook 'org-mode-hook (lambda () (org-bullets-mode 1))))
#+end_src
Use imagemagick and standalone class for latex preview.
#+begin_src emacs-lisp
(setq org-preview-latex-default-process 'imagemagick)
(setq
org-format-latex-header
"\\documentclass{standalone}
\\usepackage[usenames]{color}
[PACKAGES]
[DEFAULT-PACKAGES]
\\pagestyle{empty} % do not remove")
#+end_src
#+begin_src emacs-lisp
(use-package org-num
:delight)
#+end_src
*** org-caldav
#+begin_src emacs-lisp
(use-package org-caldav
:ensure t
:custom
(org-caldav-url private/calendar-url)
(org-caldav-calendar-id private/calendar-id)
(org-caldav-inbox "~/sync/w.org")
(org-caldav-files nil)
(org-caldav-sync-direction 'cal->org)
(org-caldav-delete-calendar-entries 'never)
(org-caldav-exclude-tags '(nocal))
)
#+end_src
*** org-clock-convenience
#+begin_src emacs-lisp
(use-package org-clock-convenience
:ensure t
:bind (:map org-agenda-mode-map
("<S-up>" . org-clock-convenience-timestamp-up)
("<S-down>" . org-clock-convenience-timestamp-down)
("<C-right>" . org-clock-convenience-fill-gap)
("<C-left>" . org-clock-convenience-fill-gap-both)))
#+end_src
*** ox-reveal
#+BEGIN_SRC emacs-lisp
(use-package ox-reveal
:ensure t)
(use-package reveal)
(setq org-reveal-root (concat "file:///home/fpi/" "reveal.js"))
;;(setq org-reveal-root "http://cdn.jsdelivr.net/reveal.js/3.0.0/")
#+END_SRC
*** ol-bbdb
#+begin_src emacs-lisp
(use-package ol-bbdb)
#+end_src
*** org-roam
#+begin_src emacs-lisp
(use-package org-roam
:delight
:hook
(after-init . org-roam-mode)
:load-path "~/git/clone/org-roam"
:custom
(org-roam-directory "~/git/projects/zettel/")
:bind (:map org-roam-mode-map
(("C-c n l" . org-roam)
("C-c n f" . org-roam-find-file)
("C-c n g" . org-roam-show-graph))
:map org-mode-map
(("C-c n i" . org-roam-insert))))
#+end_src
*** Org-edna
=Org-edna= is a great tool to manage =TODO= dependencies. I mainly use
it to mark tasks as =NEXT= after switching another task to =DONE=. The
functions below are taken from Josh's Emacs Config over at [[https://github.com/mm--/dot-emacs/blob/master/jmm-org-config.org][Github]]. He
wrote wrote a =edna-finder= which allows link descriptions and a nice
hydra to manage the various =org-edna= properties. I call it in my
[[id:22750e48-aaee-4f60-bdce-1d511ebe3375][context aware hydra]] when on an org headline. For more functions and
explanations checkout his config.
#+begin_src emacs-lisp
(use-package org-edna
:ensure t
:after org
:defer t
:config
(org-edna-load)
(defun org-edna-finder/link-ids (&rest ids)
"Find a list of headlines with given IDs.
Unlike `org-edna-finder/ids', IDS here can be links of the form \"[[id:UUID][Headline]]\" (in quotes).
This allows for easier readability of targets."
(mapcar (lambda (id) (save-window-excursion
(org-open-link-from-string id)
(point-marker)))
ids))
(defun jmm/org-edna-set-trigger-and-point (triggervalue)
"Set the TRIGGER property to TRIGGERVALUE. Move the point to
the newly set value. Open the PROPERTIES drawer."
(let ((property "TRIGGER"))
(org-entry-put (point) property triggervalue)
(org-back-to-heading t)
(let* ((beg (point))
(range (org-get-property-block beg 'force))
(end (cdr range))
(case-fold-search t))
(goto-char (1- (car range))) ;Need to go one character back to get property-drawer element
(let ((element (org-element-at-point)))
(when (eq (org-element-type element) 'property-drawer)
(org-flag-drawer nil element)))
(goto-char (car range))
(re-search-forward (org-re-property property nil t) end t))))
(defun jmm/org-edna-chain-next ()
"Set TRIGGER to chain next"
(interactive)
(jmm/org-edna-set-trigger-and-point "next-sibling todo!(NEXT) chain!(\"TRIGGER\")"))
(defun jmm/org-pop-stored-link ()
"Get the string for the previously stored link, then remove it from `org-stored-links'"
(let* ((firstlink (car org-stored-links))
(link (car firstlink))
(desc (cadr firstlink)))
(setq org-stored-links (delq (assoc link org-stored-links)
org-stored-links))
(org-make-link-string link desc)))
(defun jmm/org-edna-link (&optional rest)
"Set TRIGGER to chain next. With option"
(interactive)
(jmm/org-edna-set-trigger-and-point
(format "link-ids(\"%s\")%s" (jmm/org-pop-stored-link) (if rest (concat " " rest) ""))))
(defhydra jmm/org-edna-hydra (:color blue)
"Org Edna"
("l" jmm/org-edna-link "Link")
("L" (jmm/org-edna-link "todo!(NEXT)") "Link NEXT")
("n" (jmm/org-edna-set-trigger-and-point "next-sibling todo!(NEXT)") "Next sibling NEXT")
("N" (jmm/org-edna-set-trigger-and-point "next-sibling todo!(NEXT) chain!(\"TRIGGER\")") "Chain next-sibling NEXT")
("p" (jmm/org-edna-set-trigger-and-point "parent todo!(DONE)") "Parent DONE")
("q" nil "cancel")))
#+end_src
*** org-attach
=org-attach= is useful to attach reference material to org files. This can be reference images, data or other files. A special link type is available for attached files: ~[[attachment:file]]~.
- Inheritance :: While inheritance for attachments sounds useful, so subheadings can access their parents attachments, I find that the current implementation (Org 9.3.1) instead of inheriting just sets the attachment dir of all children to that of the parent. So for now I decided not to use it.
- Attachment Folder :: While I do not like the default double nested
folder structure it creates, I also do not want to set an individual
=DIR= property for all headings I want to attach something to.
Instead I define a new function to use the uuid directly as the
folder name.
#+begin_src emacs-lisp
(use-package org-attach
:custom
(org-attach-use-inheritance nil)
:config
(defun fpi/org-attach-id-folder-format (id)
id)
(add-to-list 'org-attach-id-to-path-function-list 'fpi/org-attach-id-folder-format))
#+end_src
=org-attach-git= auto-commits changes to attachments if the directory
is a git repository. I want every attachments to be saved using
=git-annex=. I stopped using this because the buildin =git annex
assistant= seems like a better choice, as it also handles automatic
content syncing upon commit.
#+begin_src emacs-lisp :tangle no
(use-package org-attach-git
:custom
(org-attach-git-annex-cutoff 0))
#+end_src
*** Org-Capture
Templates
#+BEGIN_SRC emacs-lisp
(use-package org-capture
:custom (
(org-journal-file (format "~/sync/journal/%s.org" (nth 2 (calendar-current-date))))
(org-capture-templates
`(("j" "Journal")
("jj" "Journal Entry (Link)"
entry
(file+olp+datetree
,org-journal-file)
;; "** %<%H:%M> %a\n %i%? \n%:description\n%:elfeed-entry-content\n%:elfeed-entry-date\n%:elfeed-entry-meta\n%:elfeed-entry-title\n%:elfeed-entry-enclosures\n%:elfeed-entry-tags" )
"** %<%H:%M> %a
%i%?" )
("je" "Journal Entry"
entry
(file+olp+datetree
,org-journal-file)
"** %<%H:%M> %?
%i" )
("i" "Interrupt"
entry
(id "802014b3-fddf-4090-b140-7fb62cb982f2")
"** Interrupt: %?
:PROPERTIES:
:CREATED: %U
:SOURCE: %a
:END:
:LOGBOOK:
:END:
"
:clock-in t
:clock-resume t)
("a" "Appointment"
entry
(id "802014b3-fddf-4090-b140-7fb62cb982f2")
"** %?
:PROPERTIES:
:CREATED: %U
:DATE: %^t
:SOURCE: %a
:END:
"
)
("b" "Bibtex entry"
entry
(id "efc97963-b714-4020-94b6-c23ad2a286ee")
(function fpi/add-org-from-doi))
;; ("a" "Appointment" entry (file "~/sync/a.org")
;; "* %i%?%(and (org-id-get-create) nil)\n:PROPERTIES:\n:CREATED: %U%(when %a \"\n:SOURCE: %a\")\n:END:\n%^t")
;; ("t" "Soonish task" entry (file "~/sync/refile.org")
;; "* NEXT %?%(and (org-id-get-create) nil)\n:PROPERTIES:\n:CREATED: %U%(when %a \"\n:SOURCE: %a\")\n:END:\n%i")
;; ("s" "Shelve something" entry (file+headline "~/sync/t.org" "Shelf")
;; "* NEXT %?%(and (org-id-get-create) nil)\n:PROPERTIES:\n:CREATED: %U%(when %a \"\n:SOURCE: %a\")\n:END:\n%i")
;; ;; ("r" "respond" entry (file "~/sync/refile.org")
;; ;; "* NEXT Respond to %:from on %:subject\n:PROPERTIES:\n:CREATED: %U\n:END:\n%a\n" :clock-in t :clock-resume t :immediate-finish t)
;; ("r" "respond" entry (file "~/sync/refile.org")
;; "* NEXT Respond to %:from on %:subject\n:PROPERTIES:\n:CREATED: %U\n:END:\n%a\n" :immediate-finish t)
;; ("n" "note" entry (file "~/sync/refile.org")
;; "* %? :NOTE:\n%U\n%a\n" :clock-in t :clock-resume t)
;; ("j" "Journal/Interruptions" entry (file+olp+datetree "~/sync/diary.org")
;; "* %?\n%U\n" :clock-in t :clock-resume t)
;; ("h" "Habit" entry (file "~/sync/refile.org")
;; "* NEXT %?\n%U\n%a\nSCHEDULED: %(format-time-string \"%<<%Y-%m-%d %a .+1d/3d>>\")\n:PROPERTIES:\n:STYLE: habit\n:REPEAT_TO_STATE: NEXT\n:END:\n")
;; ("m" "Meeting" entry (file "~/sync/refile.org")
;; "* MEETING with %? :MEETING:\n%U" :clock-in t :clock-resume t)
;; ("p" "Phone call" entry (file "~/sync/refile.org")
;; "* PHONE %? :PHONE:\n%U" :clock-in t :clock-resume t)
;; ("c" "Item to Current Clocked Task" item (clock)
;; "%i%?" :empty-lines 1)
;; ("K" "Kill-ring to Current Clocked Task" plain (clock)
;; "%c" :immediate-finish t :empty-lines 1)
;; ("p" "Gcal Appointment" entry (file "~/.emacs.d/gcal.org")
;; "* %?\n%^T\n")
;; ("z" "Zettel" entry (file "~/zettel.org")
;; "* %i%? %(and (org-id-get-create) nil)
;; :PROPERTIES:\n :CREATED: %u\n :END:\n ")
;; ("l" "Ledger")
;; ("lb" "Bank" plain (file ,(format "~/.personal/f/%s.ledger" (format-time-string "%Y")))
;; ,my/org-ledger-card-template
;; :empty-lines 1
;; :immediate-finish t)
;; ("lc" "Cash" plain (file ,(format "~/.personal/f/%s.ledger" (format-time-string "%Y")))
;; ,my/org-ledger-cash-template
;; :empty-lines 1
;; :immediate-finish t)
)
)))
#+END_SRC
Setup for floating capture window. For reference see [[https://www.windley.com/archives/2010/12/capture_mode_and_emacs.shtml][here]].
#+begin_src emacs-lisp
(defun fpi/make-floating-frame (&optional width height minibuffer name)
(interactive)
(let ((width (or width 80))
(height (or height 36))
(name (or name "*Floating Emacs*")))
(make-frame `((name . ,name)
(window-system . x)
(width . ,width)
(height . ,height)
(minibuffer . ,minibuffer)))))
(defadvice org-capture-finalize
(after delete-capture-frame activate)
"Advise capture-finalize to close the frame"
(if (equal "*Capture*" (frame-parameter nil 'name))
(delete-frame)))
(defadvice org-capture-destroy
(after delete-capture-frame activate)
"Advise capture-destroy to close the frame"
(if (equal "*Capture*" (frame-parameter nil 'name))
(delete-frame)))
(defun fpi/make-floating-capture-frame ()
(interactive)
(select-frame (fpi/make-floating-frame 70 20 t "*Capture*"))
(add-hook 'org-capture-mode-hook 'delete-other-windows)
(org-capture)
(remove-hook 'org-capture-mode-hook 'delete-other-windows))
#+end_src
*** Ricing
#+begin_src emacs-lisp
(setq line-spacing 0.1)
(setq header-line-format " ")
;; (set-face-attribute 'header-line nil :height 50) ;; make buffer-local first
;; side padding
(lambda ()
(progn
(setq left-margin-width 2
right-margin-width 2)
(set-window-buffer nil (current-buffer))))
;; try writeroom-mode
#+end_src
*** Org crypt
A small function to toggle the encryption state of the current entry.
#+begin_src emacs-lisp
(use-package org-crypt
:config
(defun fpi/org-toggle-crypt-entry ()
"Encrypt/Decrypt current headline."
(interactive)
(require 'epg)
(when (eq major-mode 'org-mode)
(unless (org-before-first-heading-p)
(org-with-wide-buffer
(org-back-to-heading t)
(org-end-of-meta-data)
(if (looking-at-p "-----BEGIN PGP MESSAGE-----")
(org-decrypt-entry)
(org-encrypt-entry))))))
(define-key fpi/toggle-map "e" #'fpi/org-toggle-crypt-entry))
#+end_src
*** org-ref
#+begin_src emacs-lisp
(use-package org-ref
:ensure t
:custom
(org-ref-bibliography-notes "~/git/projects/personal/bib.org")
(org-ref-default-bibliography '("~/git/projects/personal/bib.bib"))
(org-ref-pdf-directory "~/git/projects/personal/Lit/")
:config
(bibtex-set-dialect 'BibTeX))
#+end_src
I store my bibtex references in an org file together with my notes. In
addition to saving the meta information in properties using the same
functions as =doi-utils-doi-to-org-bibtex=, I also store them a second
time in a bibtex src block in the heading. The src blocks are tangled
to compile into a separate =.bib= file. The function below creates new
entries from a given doi and is called in my respective capture
template.
#+begin_src emacs-lisp
(defun fpi/add-org-from-doi (&optional doi)
"Get bibtex entry from doi and format as Org header with
properties and additional bibtex src block. Also downloads the
pdf if available."
(let* ((doi (or doi (read-string "Enter doi: ")))
(content (replace-regexp-in-string "\n$" "" (doi-utils-doi-to-bibtex-string doi)))
(cleaned (with-temp-buffer
(insert content)
(org-ref-clean-bibtex-entry)
(org-bibtex-read)
(buffer-substring (point-min) (point-max)))))
(with-temp-buffer
(org-mode)
(org-bibtex-write)
(goto-char (point-max))
(insert "#+BEGIN_SRC bibtex\n")
(insert cleaned)
(insert "\n#+END_SRC\n")
(org-demote)
(buffer-substring (point-min) (point-max)))))
#+end_src
Here's a function to easily copy a doi from the results of =crossref-lookup=.
#+begin_src emacs-lisp
(defun fpi/biblio-get-doi ()
(interactive)
(let ((doi (alist-get 'doi (cdr (biblio--selection-metadata-at-point)))))
(kill-new doi)
(message "Copied doi %s" doi)))
(define-key biblio-selection-mode-map "d" #'fpi/biblio-get-doi)
#+end_src
*** Todo settings
- WAITING tasks are waiting on the completion of other tasks
- NEXT tasks can be picked up
- INPROGRESS are current tasks with time clocked
- DONE are complete tasks
- ICEBOX tasks are on ice for whatever reason
TODO->DONE cycle is for habits.\\
Idle states cover things to do for time in between, checking the
inbox, reading news, …
Phonecalls?
#+BEGIN_SRC dot :file /tmp/todo.png
digraph hierarch{
node [shape=box]
// Tasks, Projects
PLANNING -> NEXT, INPROGRESS, ICEBOX
WAITING -> NEXT -> INPROGRESS -> DONE, WAITING, ICEBOX
NEXT -> WAITING -> INPROGRESS, ICEBOX
NEXT -> ICEBOX, DONE
// stuff for idle time
IDLE -> IDLE
//NEXT -> DONE
// Phonecalls, Meetings
PHONE -> DONE, CANCELED
MEETING -> DONE, CANCELED
}
#+END_SRC
#+RESULTS:
[[file:/tmp/todo.png]]
#+BEGIN_SRC emacs-lisp :tangle no
(setq org-todo-keywords '((sequence "PLANNING(p)" "NEXT(n)" "INPROGRESS(i)" "WAITING(w@/!)" "|" "ICEBOX(x@)" "DONE(d)")
(sequence "S(s)" "DONE(d)")
(sequence "PHONE(P)" "MEETING(m)" "|" "CANCELLED(c)")
(sequence "TODO(t)" "|" "DONE(d)")
(sequence "IDLE(a)")))
(setq org-use-fast-todo-selection t)
(setq org-todo-keyword-faces
'(("NEXT" :foreground "light blue" :weight bold)
("INPROGRESS" :foreground "burlywood" :weight bold)
("DONE" :foreground "forest green" :weight bold)
("WAITING" :foreground "orange" :weight bold)
("ICEBOX" :foreground "orange" :weight normal)
("CANCELLED" :foreground "forest green" :weight bold)
("MEETING" :foreground "yellow" :weight bold)
("PHONE" :foreground "yellow" :weight bold)
("IDLE" :foreground "magenta" :weight bold)))
#+END_SRC
Switch a todo entry from NEXT to INPROGRESS when clocking in.
#+begin_src emacs-lisp :tangle no
(setq org-clock-in-switch-to-state 'bh/clock-in-to-inprogress)
(defun bh/clock-in-to-inprogress (kw)
"Switch a task from NEXT to INPROGRESS when clocking in.
Skips capture tasks, projects, and subprojects.
Switch projects and subprojects from NEXT back to TODO"
(when (not (and (boundp 'org-capture-mode) org-capture-mode))
(cond
((and (member (org-get-todo-state) (list "NEXT"))
(bh/is-task-p))
"INPROGRESS")
((and (member (org-get-todo-state) (list "NEXT"))
(bh/is-project-p))
"INPROGRESS"))))
#+end_src
**** State changes
Track state changes to done & changes to schedules and deadlines.
#+begin_src emacs-lisp :tangle no
(setq org-log-done 'time)
(setq org-log-redeadline 'time)
(setq org-log-reschedule 'time)
#+end_src
*** Toggle drawer visibility
#+begin_src emacs-lisp
(setq fpi/org-meta-heading-info-store nil)
(make-variable-buffer-local 'fpi/org-meta-heading-info-store)
(defun mw-org-hide-meta-heading-info ()
"Hide meta data following headings."
(interactive)
(org-save-outline-visibility t
(save-excursion
;; (widen)
;; (org-cycle '(64))
;; (org-show-all '(drawers)) ; expand all props before make invisible to avoid ellipses.
(goto-char (point-min))
(unless (org-at-heading-p) (outline-next-heading))
(while (not (eobp))
(let ((beg (1+ (progn (end-of-line) (point))))
(end (1- (progn (org-end-of-meta-data t) (point)))))
(when (< beg end)
(push (make-overlay beg end) fpi/org-meta-heading-info-store)
(overlay-put (car fpi/org-meta-heading-info-store) 'invisible t)))
(when (not (org-at-heading-p))
(outline-next-heading))))))
(defun mw-org-show-meta-info-lines ()
"Show meta info."
(interactive)
(mapc #'delete-overlay fpi/org-meta-heading-info-store)
(setq fpi/org-meta-heading-info-store nil))
(defun fpi/org-toggle-meta-info-lines ()
(interactive)
(if fpi/org-meta-heading-info-store
(mw-org-show-meta-info-lines)
(mw-org-hide-meta-heading-info)))
(define-key fpi/toggle-map "m" #'fpi/org-toggle-meta-info-lines)
#+end_src
*** Workflow
My current workflow is largely inspired by [[http://doc.rix.si/cce/cce-org.html][Ryan Rix's]] and [[http://doc.norang.ca/org-mode.html][Bernt
Hansen's]] configs.
First set the ids of some default and often referenced tasks.
#+begin_src emacs-lisp
(setq fpi/organization-task-id "52ac704f-9cc4-4291-9721-aa3cd3b34fae")
(setq fpi/lunch-task "e3d95e3b-416d-4265-835b-1ba57aa84704"
fpi/break-task "fede843d-02fc-4cdd-8a63-91905e727dab"
;; fpi/prep-task "9d6279b8-c921-46e7-8ee4-b4d367dca1e0"
fpi/morning-flow "2bec1c12-2ee5-4f50-9eac-a018ca081d7d"
)
#+end_src
This hydra contains most parts of my current workflow. It has
everything from going to certain headlines, clocking time and
capturing notes.
#+begin_src emacs-lisp
(defhydra hydra-workflow (:hint nil)
"
Searching ----------> Do stuff --------> Do Stuff 2 -------> Workflow ---------------> Nar/Wid ------------------>
_i_: In-file headings _d_: Clock in _c_: Capture _m_: Prep meeting notes _n_: Narrow to Subtree
_h_: All headings _e_: Email _<_: Last Task _M_: Mail meeting notes _w_: Widen
_a_: Select an Agenda _l_: Lunch _j_: Jump Clock _B_: BBDB search _r_: Narrow to region
_g_: Go to active clock _b_: Break _P_: Insert BBDB _c_: Capture _t_: Show TODO Entries
_k_: Morning prep _z_: Capture Note _s_: *scratch*
_o_: Clock out _S_: Org Scratch
"
("<" bh/clock-in-last-task)
("a" org-agenda :exit t)
("B" bbdb)
("b" rrix/clock-in-break-task) ;; TODO
("c" org-capture)
("d" bh/punch-in)
("e" rrix/clock-in-email-task) ;; TODO
("g" org-clock-goto)
("h" cce/org-goto-agenda-heading)
("i" org-goto)
("j" (progn
(interactive)
(setq current-prefix-arg '(4))
(call-interactively 'org-clock-in)))
("k" rrix/clock-morning-prep)
("l" rrix/clock-in-lunch-task)
("M" bh/mail-subtree) ;; TODO ;; checkout org-mime
("m" bh/prepare-meeting-notes) ;; TODO
("n" bh/narrow-to-subtree) ;; TODO
("o" bh/punch-out)
("P" bh/phone-call) ;; TODO
("r" narrow-to-region) ;; neccessary?
("S" bh/make-org-scratch) ;; neccessary?
("s" bh/switch-to-scratch) ;; neccessary?
("t" bh/org-todo) ;; neccessary?
("w" bh/widen) ;; neccessary?
("z" cce/note-to-clock))
(define-key fpi-map (kbd "f") 'hydra-workflow/body)
#+end_src
Basic flow:
1. Start your work by clocking in with ~bh/punch-in~. This sets a
predefined "Organizational" entry as default clocking entry and
clocks you in on it.
2. To start planning your day go to "Morning prep" or directly start
working on something and clock in on it using either "Jump clock"
or ~org-clock-in~ normally.
3. Do stuff. Change clocks, capture stuff, take notes, take breaks, …
4. At the end of the day clock out with ~bh/punch-out~.
While punched in org continues to clock your time. Each time you clock
out of an entry it clocks you in on the parent entry or the default
organizational task.
#+begin_src emacs-lisp
(defun bh/clock-out-maybe ()
(when (and bh/keep-clock-running
(not org-clock-clocking-in)
(marker-buffer org-clock-default-task)
(not org-clock-resolving-clocks-due-to-idleness))
(rrix/clock-in-sibling-or-parent-task)))
(add-hook 'org-clock-out-hook 'bh/clock-out-maybe 'append)
(defun rrix/clock-in-sibling-or-parent-task ()
"Move point to the parent (project) task if any and clock in"
(let ((parent-task)
(parent-task-is-flow)
(sibling-task)
(curpoint (point)))
(save-excursion
(save-restriction
(widen)
(outline-back-to-heading)
(org-cycle)
(while (and (not parent-task) (org-up-heading-safe))
(when (member (nth 2 (org-heading-components)) org-todo-keywords-1)
(setq parent-task (point))))
(goto-char curpoint)
(while (and (not sibling-task) (org-get-next-sibling))
(when (member (nth 2 (org-heading-components)) org-todo-keywords-1)
(setq sibling-task (point))))
(setq parent-task-is-flow (cdr (assoc "FLOW"
(org-entry-properties parent-task))))
(cond ((and sibling-task
parent-task-is-flow)
(org-with-point-at sibling-task
(org-clock-in))
(org-clock-goto))
(parent-task
(org-with-point-at parent-task
(org-clock-in))
(org-clock-goto))
(t (when bh/keep-clock-running
(bh/clock-in-default-task))))))))
(defun bh/clock-in-default-task ()
(save-excursion
(org-with-point-at org-clock-default-task
(org-clock-in)
(org-clock-goto))))
#+end_src
Define the punch-in and punch-out functions.
#+begin_src emacs-lisp
(defun bh/punch-in (arg)
(interactive "p")
(setq bh/keep-clock-running t)
(if (equal major-mode 'org-agenda-mode)
(let* ((marker (org-get-at-bol 'org-hd-marker))
(tags (org-with-point-at marker (org-get-tags-at))))
(if (and (eq arg 4) tags)
(org-agenda-clock-in '(16))
(bh/clock-in-organization-task-as-default)))
(save-restriction
(widen)
(if (and (equal major-mode 'org-mode) (not (org-before-first-heading-p)) (eq arg 4))
(org-clock-in '(16))
(bh/clock-in-organization-task-as-default)))))
(defun bh/clock-in-organization-task-as-default ()
(interactive)
(org-with-point-at (org-id-find fpi/organization-task-id 'marker)
(org-clock-in '(16))))
(defun bh/punch-out ()
(interactive)
(setq bh/keep-clock-running nil)
(when (org-clock-is-active)
(org-clock-out))
(org-agenda-remove-restriction-lock))
#+end_src
Clocking into a task by id and some default clock-in functions.
The separate functions are needed so they can be used in the hydra.
#+begin_src emacs-lisp
(defun bh/clock-in-task-by-id (id)
"Clock in a task by id"
(org-with-point-at (org-id-find id 'marker)
(org-clock-in nil)))
(setq org-id-link-to-org-use-id 'create-if-interactive-and-no-custom-id)
(defun rrix/clock-in-lunch-task ()
(interactive)
(bh/clock-in-task-by-id fpi/lunch-task))
(defun rrix/clock-in-break-task ()
(interactive)
(bh/clock-in-task-by-id fpi/break-task)
(org-agenda nil "i"))
(defun rrix/clock-morning-prep ()
(interactive)
(bh/clock-in-task-by-id fpi/morning-flow)
(org-clock-goto)
;; (bh/narrow-to-subtree)
)
#+end_src
Function to clock into the last task.
#+begin_src emacs-lisp
(defun bh/clock-in-last-task (arg)
"Clock in the interrupted task if there is one
Skip the default task and get the next one.
A prefix arg forces clock in of the default task."
(interactive "p")
(let ((clock-in-to-task
(cond
((eq arg 4) org-clock-default-task)
((and (org-clock-is-active)
(equal org-clock-default-task (cadr org-clock-history)))
(caddr org-clock-history))
((org-clock-is-active) (cadr org-clock-history))
((equal org-clock-default-task (car org-clock-history)) (cadr org-clock-history))
(t (car org-clock-history)))))
(widen)
(org-with-point-at clock-in-to-task
(org-clock-in nil))))
#+end_src
Add a note to the current clock
#+begin_src emacs-lisp
(defun cce/note-to-clock ()
"Add a note to the currently clocked task."
(interactive)
(save-window-excursion
(org-clock-goto)
(org-add-note)))
#+END_SRC
Go to any heading in an agenda file (or more specifically in any file
included in 'org-refile-targets)
#+begin_src emacs-lisp
(defun cce/org-goto-agenda-heading (&optional prompt)
(interactive)
(let* ((location (org-refile-get-location (or prompt "Goto")))
(file (cadr location))
(marker (car (last location))))
(find-file file)
(goto-char marker)
(org-show-context)
(current-buffer)))
#+END_SRC
**** Filter functions
Various functions to determine if the current entry is a task, a
project or neither.
#+begin_src emacs-lisp
(defun bh/is-task-p ()
"Any task with a todo keyword and no subtask"
(save-restriction
(widen)
(let ((has-subtask)
(subtree-end (save-excursion (org-end-of-subtree t)))
(is-a-task (member (nth 2 (org-heading-components)) org-todo-keywords-1)))
(save-excursion
(forward-line 1)
(while (and (not has-subtask)
(< (point) subtree-end)
(re-search-forward "^\*+ " subtree-end t))
(when (member (org-get-todo-state) org-todo-keywords-1)
(setq has-subtask t))))
(and is-a-task (not has-subtask)))))
(defun bh/is-project-p ()
"Any task with a todo keyword subtask"
(save-restriction
(widen)
(let ((has-subtask)
(subtree-end (save-excursion (org-end-of-subtree t)))
(is-a-task (member (nth 2 (org-heading-components)) org-todo-keywords-1)))
(save-excursion
(forward-line 1)
(while (and (not has-subtask)
(< (point) subtree-end)
(re-search-forward "^\*+ " subtree-end t))
(when (member (org-get-todo-state) org-todo-keywords-1)
(setq has-subtask t))))
(and is-a-task has-subtask))))
(defun bh/find-project-task ()
"Move point to the parent (project) task if any"
(save-restriction
(widen)
(let ((parent-task (save-excursion (org-back-to-heading 'invisible-ok) (point))))
(while (org-up-heading-safe)
(when (member (nth 2 (org-heading-components)) org-todo-keywords-1)
(setq parent-task (point))))
(goto-char parent-task)
parent-task)))
(defun bh/is-project-subtree-p ()
"Any task with a todo keyword that is in a project subtree.
Callers of this function already widen the buffer view."
(let ((task (save-excursion (org-back-to-heading 'invisible-ok)
(point))))
(save-excursion
(bh/find-project-task)
(if (equal (point) task)
nil
t))))
(defun bh/skip-project-tasks ()
"Show non-project tasks.
Skip project and sub-project tasks, habits, and project related tasks."
(save-restriction
(widen)
(let* ((subtree-end (save-excursion (org-end-of-subtree t))))
(cond
((bh/is-project-p)
subtree-end)
((org-is-habit-p)
subtree-end)
((bh/is-project-subtree-p)
subtree-end)
(t
nil)))))
#+end_src
** Deft
#+begin_quote
Deft is an Emacs mode for quickly browsing, filtering, and editing
directories of plain text notes, inspired by Notational Velocity. It
was designed for increased productivity when writing and taking notes
by making it fast and simple to find the right file at the right time
and by automating many of the usual tasks such as creating new files
and saving files.
#+end_quote
I use =Deft= to organize my /Zettelkasten/. It contains many single
files about various topics. =Deft= handles searching and file
creation.
#+begin_src emacs-lisp
(use-package deft
:ensure t
:custom ((deft-directory "~/git/projects/zettel")
(deft-extensions '("org"))
(deft-default-extension "org")
(deft-use-filename-as-title nil)
(deft-recursive t)
(deft-use-filter-string-for-filename t)))
#+end_src
[[https://github.com/EFLS/zetteldeft][Zetteldeft]] provides further functions to search and link between
different /Zettel/. As /Zettel/ are scattered in separate files,
normal org file links using IDs lack in comparison to the introduced
custom link format.
#+begin_src emacs-lisp
(use-package zetteldeft
:ensure t
:bind (:map fpi-map (("d d" . deft)
("d D" . zetteldeft-deft-new-search)
("d R" . deft-refresh)
("d s" . zetteldeft-search-at-point)
("d c" . zetteldeft-search-current-id)
("d f" . zetteldeft-follow-link)
("d F" . zetteldeft-avy-file-search-ace-window)
("d l" . zetteldeft-avy-link-search)
("d t" . zetteldeft-avy-tag-search)
("d T" . zetteldeft-tag-buffer)
("d i" . zetteldeft-find-file-id-insert)
("d I" . zetteldeft-find-file-full-title-insert)
("d o" . zetteldeft-find-file)
("d n" . zetteldeft-new-file)
("d N" . zetteldeft-new-file-and-link)
("d r" . zetteldeft-file-rename)
("d x" . zetteldeft-count-words))))
#+end_src
** Shell
#+begin_src emacs-lisp
(use-package shell
:commands (shell shell-command))
#+end_src
To open and hide a shell quickly I use =shell-pop=.
#+begin_src emacs-lisp
(use-package shell-pop
:ensure t
:bind (("C-!" . shell-pop))
:custom
(shell-pop-shell-type (quote ("eshell" "*eshell*" (lambda nil (eshell))))))
#+end_src
** Grep
#+begin_src emacs-lisp
(use-package grep
:custom (grep-command "grep --color -nH --null "))
#+end_src
** Proced
Built-in process monitor.
#+BEGIN_SRC emacs-lisp
(use-package proced
:commands proced
:custom
(proced-toggle-auto-update t)
(proced-auto-update-interval 1)
(proced-descend t)
(proced-filter 'user))
#+END_SRC
** Pass
Emacs interface & mode for the password manager [[https://www.passwordstore.org/][pass/password-store]].
The emacs =pass= package provides a nice buffer listing all stored
passwords files and also a good mode to edit them. The
=password-store= package provides functions to copy and edit
individual password files. I'm not sure which one I'll end up using. I
bind a small function to copy a password or a field if called with a
prefix to my custom keymap.
#+BEGIN_SRC emacs-lisp
(use-package pass
:ensure t)
#+END_SRC
#+begin_src emacs-lisp
(use-package password-store
:ensure t
:commands (password-store-copy
password-store-edit
password-store-insert)
:custom (password-store-time-before-clipboard-restore 30)
:config (defun fpi/password-store-copy-pass-or-field (&optional arg)
(interactive "P")
(if arg
(call-interactively 'password-store-copy-field)
(call-interactively 'password-store-copy)))
:bind (:map fpi-map ("p" . fpi/password-store-copy-pass-or-field)))
#+end_src
*** auth-password-store/auth-source-pass
A password-store backend for the Emacs [[info:auth#Top][auth-source]] library which
normally uses the =~/.authinfo= file. For correct setup of
password-store files see [[https://rkm.id.au/2015/07/07/integrating-password-store-with-emacs/#fnr.1][here]] and in its [[https://github.com/DamienCassou/auth-password-store][github repo]]. For remote hosts
they need to contain the host and user info. The port is most of the
time inferred. The filename must also include the hostname. For
multiple users on the same host either use =user1@host.gpg= and
=user2@host.gpg= or =host/user1.gpg=, =host/user2.gpg=.
#+CAPTION: Example =pass= entry for use with =auth-source-pass=
#+begin_src pass-view
<password>
host: localhost
user: root
#+end_src
#+BEGIN_SRC emacs-lisp
(use-package auth-source-pass
:ensure t
:config (auth-source-pass-enable))
#+END_SRC
** Ledger
Here is a good [[https://www.reddit.com/r/emacs/comments/8x4xtt][reddit thread]] about using ledger
#+BEGIN_SRC emacs-lisp
(use-package ledger-mode
:ensure t
:init (setq ledger-clear-whole-transactions 1)
:mode "\\.dat\\'"
"\\.ledger\\'")
;; (use-package flycheck-ledger
;; :ensure t
;; :after ledger-mode)
#+END_SRC
I also use some =org-capture= templates to quickly capture
transactions. They are defined in [[file:emacs-private.el.gpg::4][emacs-private.el.gpg]].
** Elfeed
#+BEGIN_SRC emacs-lisp
(use-package elfeed
:ensure t
:init
(setq elfeed-db-directory "~/.emacs.d/elfeed")
:custom
(elfeed-enclosure-default-dir "~/Downloads")
(elfeed-search-clipboard-type 'CLIPBOARD)
(elfeed-search-title-max-width (current-fill-column))
(elfeed-search-title-min-width 30)
(elfeed-search-trailing-width 16)
(elfeed-show-truncate-long-urls t)
(elfeed-show-unique-buffers t)
:config
(defalias 'elfeed-toggle-star
(elfeed-expose #'elfeed-search-toggle-all 'star))
(defun fpi/elfeed-search-show-entry-in-bg (entry)
(interactive (list (elfeed-search-selected :ignore-region)))
(elfeed-search-show-entry entry)
(bury-buffer))
:bind
(:map elfeed-search-mode-map
("m" . elfeed-toggle-star)
("o" . fpi/elfeed-search-show-entry-in-bg)
("j" . mz/make-and-run-elfeed-hydra)
))
#+END_SRC
Some feeds I want to automatically mark as read. This way I can look
at them whenever I want to, but they don't show up in the unread search.
#+BEGIN_SRC emacs-lisp
(defun elfeed-mark-all-as-read ()
(interactive)
(save-excursion
(mark-whole-buffer)
(elfeed-search-untag-all-unread)))
(defun elfeed-mark-search-read (search-string)
"Mark all results of SEARCH-STRING as read."
(interactive)
(elfeed)
(let ((filter elfeed-search-filter))
(elfeed-search-set-filter search-string)
(elfeed-mark-all-as-read)
(elfeed-search-set-filter filter)
(bury-buffer)))
#+END_SRC
Now execute this whenever feeds are fetched
#+BEGIN_SRC emacs-lisp
(defun my/elfeed-mark-read (entry)
"Tag ENTRY as read if it contains certain tags"
(when (member 'tRaffic (elfeed-entry-tags entry))
(elfeed-untag entry 'unread)
))
(add-hook 'elfeed-new-entry-hook 'my/elfeed-mark-read)
#+END_SRC
*** Elfeed Org
Load elfeed org after adding ~my/elfeed-mark-read~ to
~elfeed-new-entry-hook~. New entries need to get tagged by elfeed org
first before marking them unread based on their tag.
#+BEGIN_SRC emacs-lisp
(use-package elfeed-org
:ensure t
:config
(elfeed-org)
(setq rmh-elfeed-org-files (list "~/.emacs.d/elfeed.org")))
#+END_SRC
*** Hydra
This creates a smart hydra based on all available tags (see
https://cestlaz.github.io/posts/using-emacs-31-elfeed-3/).
#+BEGIN_SRC emacs-lisp
(defun z/hasCap (s) ""
(let ((case-fold-search nil))
(string-match-p "[[:upper:]]" s)
))
(defun z/get-hydra-option-key (s)
"returns single upper case letter (converted to lower) or first"
(interactive)
(let ( (loc (z/hasCap s)))
(if loc
(downcase (substring s loc (+ loc 1)))
(substring s 0 1)
)))
;; (active blogs cs eDucation emacs local misc sports star tech unread webcomics)
(defun mz/make-elfeed-cats (tags)
"Returns a list of lists. Each one is line for the hydra configuratio in the form
(c function hint)"
(interactive)
(mapcar (lambda (tag)
(let* (
(tagstring (symbol-name tag))
(c (z/get-hydra-option-key tagstring))
)
(list c (append '(elfeed-search-set-filter) (list (format "@6-months-ago +%s" tagstring) ))tagstring )))
tags))
(defmacro mz/make-elfeed-hydra ()
`(defhydra mz/hydra-elfeed ()
"filter"
,@(mz/make-elfeed-cats (elfeed-db-get-all-tags))
("*" (elfeed-search-set-filter "@6-months-ago +star") "Starred")
("M" elfeed-toggle-star "Mark")
("A" (elfeed-search-set-filter "@6-months-ago") "All")
("T" (elfeed-search-set-filter "@1-day-ago") "Today")
("Q" bjm/elfeed-save-db-and-bury "Quit Elfeed" :color blue)
("q" nil "quit" :color blue)
))
(defun mz/make-and-run-elfeed-hydra ()
""
(interactive)
(mz/make-elfeed-hydra)
(mz/hydra-elfeed/body))
#+END_SRC
*** Youtube to Vlc
Open a entry with vlc
#+BEGIN_SRC emacs-lisp
(defface elfeed-youtube
'((t :foreground "#a9f"))
"Marks YouTube videos in Elfeed."
:group 'elfeed)
(push '(youtube elfeed-youtube)
elfeed-search-face-alist)
(defun elfeed-show-vlc ()
"Play the current entry with vlc."
(interactive)
(pop-to-buffer (shell-command (format "vlc %s &" (elfeed-entry-link elfeed-show-entry)))))
(defun elfeed-search-vlc ()
"Play the current entry with vlc."
(interactive)
(let ((entries (elfeed-search-selected)))
(dolist (entry entries)
(shell-command (format "vlc %s &" (elfeed-entry-link entry)))
(elfeed-untag entry 'unread)
(elfeed-search-update-entry entry)
(unless (use-region-p) (forward-line)))))
(define-key elfeed-show-mode-map "v" 'elfeed-show-vlc)
(define-key elfeed-search-mode-map "v" 'elfeed-search-vlc)
#+END_SRC
** Plotting data
=gnuplot= is a great option for plotting any kind of data, no matter
where it comes from.
#+begin_src emacs-lisp
(use-package gnuplot
:ensure t)
(use-package gnuplot-mode
:ensure t)
#+end_src
** HTML renderer
=shr= is the /Simple HTML renderer/ library, which Emacs uses to
display HTML. It is used by elfeed, notmuch and a variety of other
tools.
- Open links in =eww= instead of the system browser
- Limit the entry width to the same as =fill-column=
- Limit the size of images
#+BEGIN_SRC emacs-lisp
;; (lambda (url &rest args)
;; (if args
;; (browse-url-default-browser url)
;; (eww-browse-url url)))
(use-package shr
:commands (eww eww-browse-url)
:custom
(browse-url-browser-function 'eww-browse-url)
(browse-url-generic-program "firefox")
(shr-external-browser 'browse-url-generic)
(shr-width (current-fill-column))
(shr-max-image-proportion 0.4)
(shr-use-colors nil)
(shr-use-fonts nil) )
#+END_SRC
Support for HTML code blocks with proper syntax highlighting. See [[https://github.com/xuchunyang/shr-tag-pre-highlight.el][its GitHub project page]].
#+BEGIN_SRC emacs-lisp
(use-package shr-tag-pre-highlight
:ensure t
:after shr
:config
(add-to-list 'shr-external-rendering-functions
'(pre . shr-tag-pre-highlight))
(when (version< emacs-version "26")
(with-eval-after-load 'eww
(advice-add 'eww-display-html :around
'eww-display-html--override-shr-external-rendering-functions))))
#+END_SRC
** Email
For the setup of external mail specific programs see [[file:mail.org]].
*** Sending mail
I use =msmtp= to send mail.
- Infer the =envelope-from= header and therefore the adress to send
the mail from based on the /From/ header argument.
- Add a =-f username= flag to the sendmail command line call, as msmtp
needs it.
- Enable footnote-mode when entering message-mode.
#+begin_src emacs-lisp
(use-package message
:custom
(message-send-mail-function 'message-send-mail-with-sendmail)
(message-sendmail-envelope-from 'header)
(message-sendmail-f-is-evil nil)
(message-kill-buffer-on-exit t)
:hook (message-mode . footnote-mode))
(use-package sendmail
:custom
(send-mail-function 'smtpmail-send-it)
(sendmail-program "/usr/bin/msmtp")
(mail-specify-envelope-from t)
(mail-envelope-from 'header))
#+end_src
*** MUA/Notmuch
After using =mu4e= as my mail user agent for a while I switched to
=notmuch=. I like the tagging based approach and the easy & great
searching.
- Show newest messages first.
- Set archive tags to remove/set upon archiving a mail with =a=.
- Setup some saved searched.
- Set my signature (defined in [[file:emacs-private.el.gpg::13][emacs-private.el.gpg]]).
- Set the FCC directories where sent mails should be saved to (also
defined in [[file:emacs-private.el.gpg::20][emacs-private.el.gpg]].).
- Setup format=flowed
#+BEGIN_SRC emacs-lisp
(use-package notmuch
:ensure t
:custom
(notmuch-search-oldest-first nil)
(notmuch-archive-tags '("-inbox" "-td" "+archived"))
(notmuch-saved-searches
'((:name "inbox" :query "tag:inbox" :key "i")
(:name "unread (inb)" :query "(tag:unread and tag:inbox) or tag:td" :key "u")
(:name "unread (tot)" :query "tag:unread and date:6month..0month" :key "U")
(:name "flagged" :query "tag:flagged" :key "f")
(:name "sent" :query "tag:sent" :key "s")
(:name "drafts" :query "tag:draft" :key "d")
(:name "all mail" :query "*" :key "a")
(:name "tr" :query "tag:tr and date:6month..0month" :key "t")))
(message-signature private/message-signature)
(notmuch-fcc-dirs private/notmuch-fcc-dirs))
#+END_SRC
**** f=f
Hard new lines are identified using a ~hard~ text property and
displayed as =⏎=. We need to make sure all newlines inserted by
message initialization (signature, ...) also have this text property.
For now I use this bad code.
#+BEGIN_SRC emacs-lisp
(use-package messages-are-flowing
:ensure t
:config (add-hook 'message-mode-hook 'messages-are-flowing-use-and-mark-hard-newlines))
(defun message-insert-signature (&optional force)
(interactive)
(goto-char (point-max))
(let ((point (point)))
(message-insert-signature-original force)
(goto-char point)
(while (search-forward "\n" nil t)
(set-hard-newline-properties (- (point) 1) (point)))))
(defun message-insert-signature-original (&optional force)
"Insert a signature. See documentation for variable `message-signature'. "
(interactive (list 0))
(let* ((signature
(cond
((and (null message-signature)
(eq force 0))
(save-excursion
(goto-char (point-max))
(not (re-search-backward message-signature-separator nil t))))
((and (null message-signature)
force)
t)
((functionp message-signature)
(funcall message-signature))
((listp message-signature)
(eval message-signature))
(t message-signature)))
signature-file)
(setq signature
(cond ((stringp signature)
signature)
((and (eq t signature) message-signature-file)
(setq signature-file
(if (and message-signature-directory
;; don't actually use the signature directory
;; if message-signature-file contains a path.
(not (file-name-directory
message-signature-file)))
(expand-file-name message-signature-file
message-signature-directory)
message-signature-file))
(file-exists-p signature-file))))
(when signature
(goto-char (point-max))
;; Insert the signature.
(unless (bolp)
(newline))
(when message-signature-insert-empty-line
(newline))
(insert "-- ")
(newline)
(if (eq signature t)
(insert-file-contents signature-file)
(insert signature))
(goto-char (point-max))
(or (bolp) (newline)))))
#+END_SRC
** Footnote Mode
#+begin_src emacs-lisp
(use-package footnote
:custom
(footnote-section-tag ""))
#+end_src
** BBDB
#+begin_src emacs-lisp
(use-package bbdb
:ensure t)
(bbdb-initialize 'gnus 'message)
(bbdb-mua-auto-update-init 'gnus 'message)
;; size of the bbdb popup
(setq bbdb-pop-up-window-size 0.15)
(setq bbdb-mua-pop-up-window-size 0.15)
;; What do we do when invoking bbdb interactively
(setq bbdb-mua-update-interactive-p '(query . create))
;; Make sure we look at every address in a message and not only the
;; first one
(setq bbdb-message-all-addresses t)
;; use ; on a message to invoke bbdb interactively
(add-hook
'gnus-summary-mode-hook
(lambda ()
(define-key gnus-summary-mode-map (kbd ";") 'bbdb-mua-edit-field)))
#+end_src
** Context aware hydra
:PROPERTIES:
:ID: 22750e48-aaee-4f60-bdce-1d511ebe3375
:END:
[[https://dfeich.github.io/www/org-mode/emacs/2018/05/10/context-hydra.html][dfeich]] has a nice post on this. Basically it launches a specific hydra
based on the current mode and context around point.
#+BEGIN_SRC emacs-lisp
(defun dfeich/context-hydra-launcher ()
"A launcher for hydras based on the current context."
(interactive)
(cl-case major-mode
((org-mode org-journal-mode)
(let* ((elem (org-element-context))
(etype (car elem))
(type (org-element-property :type elem)))
(cl-case etype
(headline (jmm/org-edna-hydra/body))
(src-block (hydra-babel-helper/body))
(link (hydra-org-link-helper/body))
((table-row table-cell) (hydra-org-table-helper/body) )
(t (message "No specific hydra for %s/%s" etype type)
(hydra-org-default/body)))))
('bibtex-mode (org-ref-bibtex-hydra/body))
('ibuffer-mode (hydra-ibuffer-main/body))
(t (message "No hydra for this major mode: %s" major-mode))))
;;; *** org mode hydras
(defhydra hydra-org-default (:color pink :hint nil)
"
Org default hydra
_l_ insert template from last src block
_s_ insert src block ref with helm
_q_ quit
"
("l" fpi/copy-last-src-block-head :color blue)
("s" helm-lib-babel-insert :color blue)
("q" nil :color blue))
(defhydra hydra-org-link-helper (:color pink :hint nil)
"
org link helper
_b_ backward slurp _f_ forward slurp _n_ next link
_m_ backward barf _g_ forward barf _p_ previous link
_t_ terminal at path
_q_ quit
"
("b" org-link-edit-backward-slurp)
("f" org-link-edit-forward-slurp)
("m" org-link-edit-backward-barf)
("g" org-link-edit-forward-barf)
("n" org-next-link)
("p" org-previous-link)
("t" fpi/gnome-terminal-at-link :color blue)
("q" nil :color blue))
(defhydra hydra-org-table-helper (:color pink :hint nil)
"
org table helper
_r_ recalculate _w_ wrap region _c_ toggle coordinates
_i_ iterate table _t_ transpose _D_ toggle debugger
_B_ iterate buffer _E_ export table _d_ edit field
_e_ eval formula _s_ sort lines
_q_ quit
"
("E" org-table-export :color blue)
("s" org-table-sort-lines)
("d" org-table-edit-field)
("e" org-table-eval-formula)
("r" org-table-recalculate)
("i" org-table-iterate)
("B" org-table-iterate-buffer-tables)
("w" org-table-wrap-region)
("D" org-table-toggle-formula-debugger)
("t" org-table-transpose-table-at-point)
("c" org-table-toggle-coordinate-overlays :color blue)
("q" nil :color blue))
(defun fpi/org-babel-src-mode-hydra ()
"Launch a hydra specific to the src language of the current
babel code block if defined."
(interactive)
(let* ((elem (org-element-context))
(lang (plist-get (cadr elem) :language)))
(pcase lang
("bibtex" (org-ref-bibtex-hydra/body)))))
(defhydra hydra-babel-helper (:color pink :hint nil)
"
org babel src block helper functions
_n_ next _i_ info _I_ insert header
_p_ prev _c_ check _m_ ode hydra
_h_ goto head _E_ expand
^ ^ _s_ split
_q_ quit _r_ remove result _e_ examplify region
"
("i" org-babel-view-src-block-info)
("I" org-babel-insert-header-arg)
("c" org-babel-check-src-block :color blue)
("s" org-babel-demarcate-block :color blue)
("n" org-babel-next-src-block)
("p" org-babel-previous-src-block)
("E" org-babel-expand-src-block :color blue)
("e" org-babel-examplify-region :color blue)
("r" org-babel-remove-result :color blue)
("h" org-babel-goto-src-block-head)
("m" fpi/org-babel-src-mode-hydra :color blue)
("q" nil :color blue))
;;; *** ibuffer hydra
;; from https://github.com/abo-abo/hydra/wiki/Ibuffer
(defhydra hydra-ibuffer-main (:color pink :hint nil)
"
^Navigation^ | ^Mark^ | ^Actions^ | ^View^
-^----------^-+-^----^--------+-^-------^--------+-^----^-------
_p_: ʌ | _m_: mark | _D_: delete | _g_: refresh
_RET_: visit | _u_: unmark | _S_: save | _s_: sort
_n_: v | _*_: specific | _a_: all actions | _/_: filter
-^----------^-+-^----^--------+-^-------^--------+-^----^-------
"
("n" ibuffer-forward-line)
("RET" ibuffer-visit-buffer :color blue)
("p" ibuffer-backward-line)
("m" ibuffer-mark-forward)
("u" ibuffer-unmark-forward)
("*" hydra-ibuffer-mark/body :color blue)
("D" ibuffer-do-delete)
("S" ibuffer-do-save)
("a" hydra-ibuffer-action/body :color blue)
("g" ibuffer-update)
("s" hydra-ibuffer-sort/body :color blue)
("/" hydra-ibuffer-filter/body :color blue)
("o" ibuffer-visit-buffer-other-window "other window" :color blue)
("q" nil "quit" :color blue))
(defhydra hydra-ibuffer-mark (:color teal :columns 5
:after-exit (hydra-ibuffer-main/body))
"Mark"
("*" ibuffer-unmark-all "unmark all")
("M" ibuffer-mark-by-mode "mode")
("m" ibuffer-mark-modified-buffers "modified")
("u" ibuffer-mark-unsaved-buffers "unsaved")
("s" ibuffer-mark-special-buffers "special")
("r" ibuffer-mark-read-only-buffers "read-only")
("/" ibuffer-mark-dired-buffers "dired")
("e" ibuffer-mark-dissociated-buffers "dissociated")
("h" ibuffer-mark-help-buffers "help")
("z" ibuffer-mark-compressed-file-buffers "compressed")
("b" hydra-ibuffer-main/body "back" :color blue))
(defhydra hydra-ibuffer-action (:color teal :columns 4
:after-exit
(if (eq major-mode 'ibuffer-mode)
(hydra-ibuffer-main/body)))
"Action"
("A" ibuffer-do-view "view")
("E" ibuffer-do-eval "eval")
("F" ibuffer-do-shell-command-file "shell-command-file")
("I" ibuffer-do-query-replace-regexp "query-replace-regexp")
("H" ibuffer-do-view-other-frame "view-other-frame")
("N" ibuffer-do-shell-command-pipe-replace "shell-cmd-pipe-replace")
("M" ibuffer-do-toggle-modified "toggle-modified")
("O" ibuffer-do-occur "occur")
("P" ibuffer-do-print "print")
("Q" ibuffer-do-query-replace "query-replace")
("R" ibuffer-do-rename-uniquely "rename-uniquely")
("T" ibuffer-do-toggle-read-only "toggle-read-only")
("U" ibuffer-do-replace-regexp "replace-regexp")
("V" ibuffer-do-revert "revert")
("W" ibuffer-do-view-and-eval "view-and-eval")
("X" ibuffer-do-shell-command-pipe "shell-command-pipe")
("b" nil "back"))
(defhydra hydra-ibuffer-sort (:color amaranth :columns 3)
"Sort"
("i" ibuffer-invert-sorting "invert")
("a" ibuffer-do-sort-by-alphabetic "alphabetic")
("v" ibuffer-do-sort-by-recency "recently used")
("s" ibuffer-do-sort-by-size "size")
("f" ibuffer-do-sort-by-filename/process "filename")
("m" ibuffer-do-sort-by-major-mode "mode")
("b" hydra-ibuffer-main/body "back" :color blue))
(defhydra hydra-ibuffer-filter (:color amaranth :columns 4)
"Filter"
("m" ibuffer-filter-by-used-mode "mode")
("M" ibuffer-filter-by-derived-mode "derived mode")
("n" ibuffer-filter-by-name "name")
("c" ibuffer-filter-by-content "content")
("e" ibuffer-filter-by-predicate "predicate")
("f" ibuffer-filter-by-filename "filename")
(">" ibuffer-filter-by-size-gt "size")
("<" ibuffer-filter-by-size-lt "size")
("/" ibuffer-filter-disable "disable")
("b" hydra-ibuffer-main/body "back" :color blue))
#+END_SRC
* Language settings
End sentences with single spaces.
#+begin_src emacs-lisp
(setq sentence-end-double-space nil)
#+end_src
* Interface
** General
#+begin_src emacs-lisp
(use-package emacs
:custom
(vc-follow-symlinks t)
(echo-keystrokes 0.25)
(auto-revert-verbose nil)
:config
(defalias 'yes-or-no-p 'y-or-n-p)
(put 'dired-find-alternate-file 'disabled nil)
(put 'narrow-to-region 'disabled nil))
#+end_src
** Parentheses
#+begin_src emacs-lisp
(use-package paren
:custom
(show-paren-style 'mixed)
(show-paren-when-point-in-periphery t)
(show-paren-when-point-inside-paren t)
:config
(show-paren-mode 1))
#+end_src
** Whitespace
I do not really care about spaces versus tabs most of the time. I only
want it to be consistent within a file.
#+begin_src emacs-lisp
(use-package emacs
:custom
(indent-tabs-mode nil))
#+end_src
Instead of =$= use =⏎= to indicate newlines
#+begin_src emacs-lisp
(use-package whitespace
:custom (whitespace-display-mappings '((space-mark 32
[183]
[46])
(space-mark 160
[164]
[95])
(newline-mark 10
[9166 10]) ;;[36 10]
(tab-mark 9
[187 9]
[92 9]))))
#+end_src
** Undo
Emacs undo mechanic can be confusing. =undo-tree= is a great package
but is prone to corruption and also does not allow undo based on the
active region.
*** Undo-propose :ARCHIVE:
=undo-propose= shows undo changes in a temporary buffer. For the
keybindings see [[elisp:(which-key-show-full-keymap
'undo-propose-mode-map)]]. =undo-propose-commit= commits the cumulated
undo changes and the traveled undo history to the original buffer.
=undo-propose-squash-commit= omits the history.
The temporary buffer messes up point and folding in org buffers.
Therefore I don't use it anymore and should someday look into how this
temporary buffer is created.
#+begin_src emacs-lisp :tangle no
(use-package undo-propose
:ensure t
:bind (("C-/" . undo-propose)))
#+end_src
** Electric stuff
#+begin_src emacs-lisp
(use-package electric
:init
(setq electric-pair-inhibit-predicate 'electric-pair-conservative-inhibit)
(setq electric-pair-pairs '((34 . 34)
(8216 . 8217)
(8220 . 8221)
(171 . 187)))
(setq electric-pair-skip-self 'electric-pair-default-skip-self)
(setq electric-quote-context-sensitive t)
(setq electric-quote-paragraph t)
(setq electric-quote-string nil)
:config
(electric-indent-mode 1)
(electric-pair-mode 1)
(electric-quote-mode -1))
#+end_src
|