[RUBY] J'ai fait un petit bijou pour poster le texte du mode org sur qiita

introduction

qiita \ _org est un joyau qui publie du texte écrit en mode org emacs sur Qiita. Je l'ai créé sur la base de l'idée que ce serait bien si cui pouvait être utilisé pour créer et publier des articles.

Cet article décrit un exemple d'utilisation de qiita \ _org et comment l'installer et l'initialiser. Veuillez vous référer à https://qiita.com/yamatoken/items/9314161758e778fd82c0 pour la commande de qiita \ _org.

Remarque: puisque la commande \ _line est utilisée, la version ruby doit être 2.4.0 ou supérieure. Nous recommandons également emacs version 26.3 ou supérieure.

Sous Windows, nous avons confirmé l'opération dans l'environnement suivant.

Cependant, entrez sur MacOS lors de l'exécution du modèle qiita.

Exemple d'utilisation

Tout d'abord, obtenez le modèle de publication pour le mode org. Tapez'qiita template ', décidez si vous souhaitez écrire l'environnement et créez template.org. 

Ensuite, une telle organisation est créée. 

Changez le titre et la balise ici pour ceux pour mettre sur qiita, puis écrivez simplement le texte comme avant.

Une fois le texte créé, il ne vous reste plus qu'à exécuter la commande de publication. Lorsque j'essaye de publier sur la publication partagée limitée, cela ressemble à ceci. 

Cela semblera bâclé, mais si les paramètres sont correctement définis, la publication sera terminée et la page publiée dans Safari s'ouvrira.

L'article publié vous montrera dans quel répertoire le texte d'origine de l'organisation se trouve en tant que source, il devrait donc être utile même si vous souhaitez modifier l'article précédent. .. ..

Comment installer

gem install qiita_org

Si qiita et la liste des commandes s'affichent, l'installation est terminée avec succès.

Réglage initial

Installez pandoc

sur mac

brew install pandoc

avec ubuntu

sudo apt update
sudo apt install pandoc

Créer un fichier de configuration

qiita config global

Et créez un fichier de paramètres dans le répertoire personnel.

Comment créer un jeton d'accès Qiita et écrire dans le fichier de configuration

À https://qiita.com/settings/applications

Cliquez sur «Émettre un nouveau jeton» pour votre jeton d'accès personnel. 

Écrivez une description du jeton d'accès et vérifiez tout dans la portée comme indiqué dans l'image. Puis émettez-le. 

Lorsque la page se déplace, le jeton d'accès est affiché dans le jeton d'accès personnel, alors copiez-le. (Veuillez noter que cette chaîne de caractères ne peut pas être affichée à nouveau lorsque la page est déplacée.)

Revenez au terminal et exécutez comme suit.

qiita config global access_token 'your accesstoken'

Collez le jeton d'accès que vous avez copié précédemment à la place de «votre jeton d'accès».

Enregistrement du nom

qiita config global name 'your name'

Enregistrez votre adresse e-mail

qiita config global email 'your email'

Enregistrement de l'URL de l'équipe Qiita

Il est nécessaire d'utiliser l'option appelée «équipes», donc si vous avez une équipe Qiita à laquelle vous appartenez, veuillez effectuer ce réglage. Sinon, vous n'avez pas à le définir.

qiita config global teams_url 'https://foge.qiita.com/'

Veillez à ne pas oublier d'ajouter un «/» à la fin de l'URL.

paramètres ox-qmd

Pour plus d'informations sur ox-qmd, consultez l'article ci-dessous. Référence: J'ai créé un package pour exporter un Markdown compatible Qiita à partir du mode organisationnel

https://github.com/0x60df/ox-qmd ox-qmd.el '~ / .emacs.d / site Créez-le dans \ _lisp '.

Pour transmettre le PATH à emacs, ajoutez ce qui suit à init.el.

init.el

;;Définir l'emplacement du fichier el
(setq load-path (cons "~/.emacs.d/site_lisp" load-path))

...

(require 'ox-qmd)
(add-to-list 'ox-qmd-language-keyword-alist '("ruby" . "ruby"))

Comment créer un fichier de configuration local

Si vous appartenez à plusieurs équipes ou si vous souhaitez définir une adresse e-mail pour chaque répertoire, vous pouvez spécifier un fichier de paramètres locaux.

Dans le répertoire où vous souhaitez créer le fichier de paramètres

qiita config local set

Et vous pouvez écrire de la même manière que les paramètres initiaux ci-dessus.

• source ~/Github/grad_research_20s/yamato/test/qiita_org_manual.org