wiki/notebook/web.forges.recognize-plain-text-documents.org

:PROPERTIES:
:ID:       ae9b5d09-3a46-4173-b9b2-0232f583b16d
:END:
#+title: Make web forges recognize plain-text documents
#+date: "2021-06-24 18:17:37 +08:00"
#+date_modified: "2021-07-20 23:32:51 +08:00"
#+language: en


Some of the web forges such as GitHub and Gitlab uses [[https://github.com/github/linguist][linguist]] framework to recognize the language and blob files.
By setting Git attributes with =.gitattributes= file, you can set a certain option to make it recognize the plain-text files.
It is what makes the technology list from the repo.

Oftentimes in these web forges, linguist is configured to not detect certain files like plain-text documents (e.g., Markdown, Asciidoctor, Org mode, ReStructuredText).

Here's an example =.gitattributes= file to make Org mode and Asciidoctor documents be recognized.

#+begin_src gitattributes
*.org linguist-detectable=true
*.adoc linguist-detectable=true
#+end_src
Merge evergreen notes into the notebook Now, it's all under the notebook umbrella. Seems to be appropriate as it is just my notes after all. I also updated some notes from there. I didn't keep track of what it is this time. Something about more learning notes extracted from my "Learning how to learn" course notes and then some. Lack of time and hurriness just makes it difficult to track but it should be under version control already. 2021-07-21 08:28:07 +00:00			`:PROPERTIES:`
			`:ID: ae9b5d09-3a46-4173-b9b2-0232f583b16d`
			`:END:`
Update notebook and clean up the folder I also forget to add the additional solutions from the Exercism exercises. Whoops... I'm also getting used to storing code in random places. Time to change that habit a little bit by storing them in my notebook, instead. Nothing wrong with that, yeah?! 2021-06-25 05:30:07 +00:00			`#+title: Make web forges recognize plain-text documents`
			`#+date: "2021-06-24 18:17:37 +08:00"`
Merge evergreen notes into the notebook Now, it's all under the notebook umbrella. Seems to be appropriate as it is just my notes after all. I also updated some notes from there. I didn't keep track of what it is this time. Something about more learning notes extracted from my "Learning how to learn" course notes and then some. Lack of time and hurriness just makes it difficult to track but it should be under version control already. 2021-07-21 08:28:07 +00:00			`#+date_modified: "2021-07-20 23:32:51 +08:00"`
Update notebook and clean up the folder I also forget to add the additional solutions from the Exercism exercises. Whoops... I'm also getting used to storing code in random places. Time to change that habit a little bit by storing them in my notebook, instead. Nothing wrong with that, yeah?! 2021-06-25 05:30:07 +00:00			`#+language: en`


			`Some of the web forges such as GitHub and Gitlab uses [[https://github.com/github/linguist][linguist]] framework to recognize the language and blob files.`
			`By setting Git attributes with =.gitattributes= file, you can set a certain option to make it recognize the plain-text files.`
			`It is what makes the technology list from the repo.`

			`Oftentimes in these web forges, linguist is configured to not detect certain files like plain-text documents (e.g., Markdown, Asciidoctor, Org mode, ReStructuredText).`

			`Here's an example =.gitattributes= file to make Org mode and Asciidoctor documents be recognized.`

			`#+begin_src gitattributes`
			`*.org linguist-detectable=true`
			`*.adoc linguist-detectable=true`
			`#+end_src`