diff --git a/.gitignore b/.gitignore index 8d01d09..517fa19 100644 --- a/.gitignore +++ b/.gitignore @@ -51,3 +51,14 @@ flycheck_*.el # local directory local/ +# pdf or html files +*.pdf +*.html + +# office files +*.odt +*.odf + +# images +*.jpeg +*.png diff --git a/README.org b/README.org index 8309543..a7bcff2 100644 --- a/README.org +++ b/README.org @@ -6,9 +6,9 @@ specific packages that are needed for their tasks. Emacs is free software project with many years of development and a very active - community. + and friendly community. - This editor can be used for multiple purposes, for instance: + Emacs can be used for multiple purposes, for instance: - Edit files from different programming languages or any plain text - Access a shell and execute tasks in a machine @@ -25,8 +25,8 @@ * Contents - * [[./doc/init_emacs.org][Initialize emacs]] - * [[./doc/help.org][Manuals and help about using emacs]] + * [[./doc/init_emacs.org][How to initialize emacs]] + * [[./doc/help.org][Find manuals and help to use emacs]] * [[./doc/movement.org][Movement and text edition]] * [[./doc/using_meta.org][Using 'meta' (M-x)]] * [[./doc/using_alt.org][Using 'Alt' (M)]] @@ -38,6 +38,7 @@ * [[./doc/packages.org][Dealing with packages in emacs]] * [[./doc/R_in_emacs.org][Using R in emacs]] * [[./doc/links_emacs.org][Links to learn more about emacs]] + * [[./doc/citations.org][How to include bibliograpic references in org documents]] * Contenido diff --git a/doc/bibliog.bib b/doc/bibliog.bib new file mode 100644 index 0000000..8a1f788 --- /dev/null +++ b/doc/bibliog.bib @@ -0,0 +1,9 @@ +@article{OrgCitations, + author={org, mode and Syntax, Citation and List, Mailing and Effort, Time}, + journal={Journal of Plain Text Formats}, + title={Elegant Citations with Org-Mode}, + year={2021}, + month={7}, + volume={42}, + number={1}, + pages={2-3}} diff --git a/doc/citations.org b/doc/citations.org new file mode 100644 index 0000000..406c9b1 --- /dev/null +++ b/doc/citations.org @@ -0,0 +1,56 @@ +#+date: 2022-07-03 +#+bibliography: ./bibliog.bib +#+bibliography: ~/Documentos/bib/lepto-ref.bib + +* How to make citations using Emacs org-mode + +:LOGBOOK: +CLOCK: [2022-07-03 dom 09:57]--[2022-07-03 dom 10:27] => 0:30 +:END: + +It is possible to include blibligraphic citations within org documents. + +Interesting information about org-cite can be found in the manual. + +Use ~C-h~ ~i~ in emacs to access the manual and then access the org-manual navigating +in the menu (use the letter ~m~ and type 'org..') + +See Org Manual -> Citation handling -> Citations + +** Include a header linking a file with references + +It should be something like this at the beggining of your document: + +#+begin_example +#+bibliography: SomeFile.bib +#+bibliography: /some/other/file.json +#+end_example + +Here the file may be a '.bib' , 'bibtex' or a '.json' document. + +** Including citation + +You can use 'C-c C-x @' (org-cite-insert) to include references from the linked +file. For instance: + +[cite:/s/v/@OrgCitations] + +Citing from the second file [cite:/s/v/@bernard_leptospirosis_1993] + +** Print bibliography + +Use the following to print the references: + +#+begin_example org +#+print_bibliography: +#+end_example + + +** Some cool documents to learn more about bibliography management in org-mode + +* References + +- About 'org-ref: https://github.com/jkitchin/org-ref +- About 'org-cite': https://blog.tecosaur.com/tmio/2021-07-31-citations.html#org367f817 + +#+print_bibliography: diff --git a/doc/dired.org b/doc/dired.org index 1db2ebd..55acbd7 100644 --- a/doc/dired.org +++ b/doc/dired.org @@ -41,6 +41,7 @@ This includes all temporary files in dired and kill with "D" * Avoid ido auto complete to rename a file with similar name to those in directory * Once you've typed the filename you want, hit C-j instead of RET. - * You can temporarily switch back to the "normal" minibuffer behaviour by hitting C-f. Then you can tab-complete the old filename, and edit it as needed. + * You can temporarily switch back to the "normal" minibuffer behaviour by hitting C-f. + Then you can tab-complete the old filename, and edit it as needed. * From [[https://stackoverflow.com/questions/23741014/how-to-stop-auto-complete-from-overwriting-a-file-that-is-similarly-named][Stackoverflow]] * To use ~nano~ editor within emacs use 'CTRL+shift+x' instead of 'CTRL+X' diff --git a/doc/org_intro.org b/doc/org_intro.org index a0120dd..8a9b418 100644 --- a/doc/org_intro.org +++ b/doc/org_intro.org @@ -2,10 +2,18 @@ * org mode -To opemn the org manual: +To open the org manual using "meta" within emacs: : M-x org-info +Optionally you can use the following keybinding to open a buffer with the info +version of manuals: + +: C-h i + +Then, in the buffer type the key "m" to search in the menu by keywords. To find +the org info manual, just type "Org mode" in the menu. + ** Create task list and include date and time Save a ".org" file. Then write your tasks using "*" to show hierarchy or nesting @@ -13,7 +21,7 @@ structure in tasks. ** Using Pomodoro in org mode -- Install pomodoro +- Install pomodoro in emacs : M-x [RET] package-install org-pomodoro @@ -25,6 +33,8 @@ structure in tasks. : M-x [RET] org-pomodoro +PS: "RET" is the same "enter" key + ** org-babel Reference for header arguments: diff --git a/doc/references.odt b/doc/references.odt deleted file mode 100644 index 6a6a20e..0000000 Binary files a/doc/references.odt and /dev/null differ diff --git a/doc/references.org b/doc/references.org index 4581d18..139597f 100644 --- a/doc/references.org +++ b/doc/references.org @@ -1,25 +1,2 @@ -#+title: How to include references in Emacs org-mode -#+bibliography: ~/Documentos/bib/lepto-ref.bib -https://blog.tecosaur.com/tmio/2021-07-31-citations.html#org367f817 - - -* Insert citations - -Use 'org-cite-insert' (C-c C-x @) - -[cite:/s/v/@bernard_leptospirosis_1993] - - -* References - -org-ref -https://github.com/jkitchin/org-ref - -org-cite - -https://blog.tecosaur.com/tmio/2021-07-31-citations.html#fn.3 - -#+print_bibliography: - diff --git a/doc/using_alt.org b/doc/using_alt.org index ba81227..60d8eb0 100644 --- a/doc/using_alt.org +++ b/doc/using_alt.org @@ -1,4 +1,4 @@ -#+DATE: 2021 +#+date: 2021 * Commands @@ -12,7 +12,7 @@ Use the following keybindings to edit in emacs ** Using 'Alt' (M) #+Caption: Use meta 'M' (ALT key) in emacs - +|-----------+-----------+-----------------------------------| | Keystroke | Keystroke | Action | |-----------+-----------+-----------------------------------| | M | w | Copy text | diff --git a/doc/using_ctrl.org b/doc/using_ctrl.org index 561c2f0..33ef26f 100644 --- a/doc/using_ctrl.org +++ b/doc/using_ctrl.org @@ -1,11 +1,16 @@ -#+DATE: 2021 +#+date: 2021 * Commands -Use CTRL (C), ALT (M), Ctrl + x (C-x) or ALT + x ( M-x) to edit +Use the following keybindings to edit in emacs + + * CTRL (C) + * ALT (~M~) + * CTRL + x (~C-x~) + * ALT + x (~M-x~) #+Caption: Some examples on how to use 'Ctrl' in emacs - +|-----------+--------------------------+-----------------------------------------------------------| | Keystroke | Keystroke | Action | |-----------+--------------------------+-----------------------------------------------------------| | C | tab | Changing tab view | @@ -44,11 +49,12 @@ Use CTRL (C), ALT (M), Ctrl + x (C-x) or ALT + x ( M-x) to edit | | \ | Enable or disable input method | | | c-C-, | org-insert-structure-template | | |