18f.gsa.gov: gdocからmarkdownへの変換プロセスを改善する

作成日 2017年01月25日  ·  23コメント  ·  ソース: 18F/18f.gsa.gov

ブログ投稿が完了し、承認され、投稿する準備ができたら、サイトのマークダウンに変換する必要があります。 そのプロセスはここに文書化されていますが、非常にでこぼこです。

現在の問題点:

  • すべてのリンクはイタリック体で示されています
  • ドル記号がドル記号として出てこない
  • アイテムの長さが1行を超えるリストは、ブロッククォートとして表示されます
  • グーグルドキュメントでカスタムスタイル(つまりオレンジ色の見出し)を使用する場合、一部のリンクはリンクではなくフォントファイルの参照として表示されます
  • 見出しは信頼できません
  • フロントマターは大丈夫ですが、人々はそれを正しく入力するのが苦手です
  • 画像が表示されない

    • gdocをウェブページとしてエクスポートしてから、画像を抽出して手動で再追加する必要があります

  • コードスニペットが壊れます
  • リストアイテム間にスペースを追加する
Parking lot blog-feature

最も参考になるコメント

@awfrancisco次に話すときは、ブログワークフロー全体について、そしてこのプロセスを改善する上流の機会があるかどうか(gdocs内にマークダウンを書き込むなど)について質問したいと思います。プロセス全体を理解すると、私たちができることを少しよく理解するのに役立ちます。 /変更できません。

全てのコメント23件

これらのバグは、 pandocを使用すると生成されることに注意してください。 ここで未解決のpandocの問題を見つけて

@elainekamlley @gbooneに追加するバグがありますか?

これが私が探しているすべてのもののリストです—私が覚えているとき。

このリストの6番は、画像を取得する別の方法です。

また、このスクリプトは、GoogleドキュメントをMarkdownに直接エクスポートするのに最適です。 毎回動作させるのは少し面倒ですが、正しく動作していない可能性があります。

スクリプトは探索するのに適したオプションのようです—このバリアントも有望に見えます。

これが現在、単純なブログ投稿にかかる時間の見積もりはありますか? より複雑な投稿については?

より詳しい情報! 経由Pandocを使用してodtの代わりにdocx問題のいくつか、書式設定、特に変なリストを解決しているようです。

これらの問題の多くは、Word->マークダウンステップではなく、プロセスのGDocs-> Word部分で発生していると思われるため、暫定ステップを削除する方法を検討する必要があると思います。

このGoogleスクリプトは、pandocの代わりに試されましたか? 私は今それを試しました、そしてそれはいくつかの問題を解決したように見えました、しかし前線を壊しました。

convert to markdown -> check email -> amend any errorsは許容できる新しいワークフローですか、それとも以前よりもさらに悪いですか?

おっと! 投稿する前にこのスレッドを読む必要があります。 このオプションは検討されている/検討されているようです😀

@gbooneはもっと知っているでしょうが、Google Scriptsの使用は許可されていないか、ドキュメントごとに再インストールする必要があると思います。 それを一種の苦痛にするいくつかの高い負担があります。

少なくとも1つのGoogleScriptのOCIO審査フォームを送信して、そのプロセスを実行できるかどうかを確認しました。 それがうまくいけば、そのスクリプトを再び使用できるようになることを願っています。

ええ、 @ awfranciscoの説明は私の経験と一致しています—スクリプトを使用するたびにスクリプトを再インストールする必要があります。 私はそれらを承認するためのこのフォームに気づいていませんでしたが、私はずっと前にそれについてのITヘルプデスクの問題を開きました。 フォームが私たちのために働くことを指が交差しました。

@awfrancisco次に話すときは、ブログワークフロー全体について、そしてこのプロセスを改善する上流の機会があるかどうか(gdocs内にマークダウンを書き込むなど)について質問したいと思います。プロセス全体を理解すると、私たちができることを少しよく理解するのに役立ちます。 /変更できません。

Google Scriptについての返信があるまで、これをブロック済みとしてマークします。

「より良い」がどのように見えるかについての最初の仮説:

  • リストのスタイルを修正する必要はありません(ODTを介したpandocが役立つ場合があります)
  • 改行を編集する代わりに、フロントマターをコピーして貼り付けます
  • 物事をスピードアップするのに役立つより良いキーボードショートカット—文書化

修正する可能性が低いもの:

  • 画像
  • 特殊文字? (odtオプションを確認してください)
  • コードスニペット(直接コピー/貼り付けできるように、GitHubの要点に入れるように人々に依頼してください)

これがどこにあるかについての更新:

数週間前、GSAITにGoogleスクリプトの使用を承認するようリクエストを送信しました。

承認されるということは、アドオンとして利用できるということだと思いましたが、承認するということは、機能的に違うということではなく、トラブルが発生しないということです。

アドオンとして機能することを確認するために、私は自分の個人的なGmailアカウントでテストし、参照用に投稿しました。

>>機能するアドオンスクリプト<<

私のために働いたステップ(SDKを構成することを確認してください):

  1. アドオン#before_you_publish
  2. アドオン

これはプラグアンドプレイタイプのものではないことに注意することが重要です。 #infrastructure :(で処理する必要のあるアカウント構成がたくさんありました。幸い、 @ gbooneはOutreachのインフラ

私がGSAITから話していた人にアドオンについて言及しましたが、彼は承認について知りませんでした。 それを念頭に置いて、次のステップは次のとおりです。

  • [] Markdownとしてエクスポートに似たアドオンを作成するスクリプトが機能していることを伝えます

    • []誰かがアドオンを作成したかどうかを確認します

    • []そうでない場合は、アドオンとスタンドアロンスクリプトで承認プロセスがどのように異なるかを誰かが知っているかどうかを確認してください

  • []構成プロセスを通じて助けを得るようにしてください
  • []プランB: pandocの使用に固執しますが、プロセスを合理化する方法に関するドキュメントを更新します

現在、いくつかの異なる方法でこの問題に取り組むためにピボットしています。

  • [] @gbooneは、gdocs-> odt->マークダウンの変換に現在使用されているベストプラクティスを文書化する予定です。 GIF FTW!
  • []同じことをするためにブックマークレットを作ることを検討します
  • [] Gregと私は引き続きGSAITと協力して、作成しExport asMarkdownアドオンを組織全体での使用が承認されるようにする方法を見つけます。

cc @toolness @jeremyzilar

@gbooneはこれで

@elainekamlleyとりあえずこれを開いたままにして

RenatoManginiのスタンドアロンスクリプトを使用した後にアドオンとして開発した無料の

すばらしいニュース@ evbacher🎉テストしてから、GSAでの承認プロセスを実行します。 これにとても興奮しています

これを行うためのリソースがありません。 私たちがリソースを手に入れたら、持っているといいでしょう。 これを駐車場に移動します。 エンジニアリングリソースが必要な場合があります

承認のためにgd2mdましhttps://github.com/evbacher/gd2md-html/wiki

現時点で取り組むのに十分なリソースがありません。

このページは役に立ちましたか?
0 / 5 - 0 評価

関連する問題

coreycaitlin picture coreycaitlin  ·  5コメント

konklone picture konklone  ·  4コメント

gboone picture gboone  ·  16コメント

gboone picture gboone  ·  15コメント

coreycaitlin picture coreycaitlin  ·  12コメント