GitHub で超簡単に静的サイトをホスティングする！ - Qiita
githubからファイルをダウンロードする: GitHub - lemon2003/page-hosting またはclone: https://github.com/lemon2003/page-hosting.git Step3. 作成したファイルを、リモートリポジトリにプッシュしたいと思います。 1. git init で初期化 2. git add --all ですべてのファイルをステージング 3. git commit -m "commit comment" でコミット 4. git remote add origin リモートURL でリモートを追加 5. git push -u origin master で master ブランチにプッシュ bash User@DESKTOP MINGW64 /e/page-hosting (master) $ git init Initi
【Python】良い書き方と悪い書き方を知って中級者を目指す🐍 - Qiita
Pythonでコードを書くときのGood/Badプラクティス こちらの記事は、DuomlyによりDev.to上で公開された『 Good and Bad Practices of Coding in Python 』の邦訳版です（原著者から許可を得た上での公開です） 元記事：Good and Bad Practices of Coding in Python ※ 記事の内容に注意すべき点と誤りがあるので、詳しくは注釈まで目を通すことをおすすめします。 （以下、翻訳した本文） この記事は元々 https://www.blog.duomly.com/good-and-bad-practices-of-coding-in-python/ に公開されたものです。 Pythonは可読性を重視した高水準のマルチパラダイムプログラミング言語です。Pythonは、「Pythonの禅」、別名ではPEP 20と
[Python]可読性を上げるための、docstringの書き方を学ぶ（NumPyスタイル） - Qiita
日々Pythonの色々な記事がアップされているものの、あまりdocstringに触れている日本語の記事が少ないな・・ということで書きました。 そもそもdocstringって？ Pythonの関数だったりクラスだったりに記述するコメントです。 JSDocだったりのPython版です。 書き方は、最初結構他の言語と違うな・・という印象を受けました。 docstring書くと何が嬉しいの？ 後で見直したときに、すぐ内容が把握できるよ Guido の重要な洞察のひとつに、コードは書くよりも読まれることの方が多い、というものがあります。 はじめに — pep8-ja 1.0 ドキュメント 最初は少し時間がかかっても、書いておくと後でコードを読み直した時の負担が減ります。 関数などを扱う際に、内容を見たりできるよ jupyter などであれば、nbextentionsでhinterlandを有効化する
![[Python]可読性を上げるための、docstringの書き方を学ぶ（NumPyスタイル） - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/dfaa047843f04e332970c0a74f1e00605d8ee219/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9JTVCUHl0aG9uJTVEJUU1JThGJUFGJUU4JUFBJUFEJUU2JTgwJUE3JUUzJTgyJTkyJUU0JUI4JThBJUUzJTgxJTkyJUUzJTgyJThCJUUzJTgxJTlGJUUzJTgyJTgxJUUzJTgxJUFFJUUzJTgwJTgxZG9jc3RyaW5nJUUzJTgxJUFFJUU2JTlCJUI4JUUzJTgxJThEJUU2JTk2JUI5JUUzJTgyJTkyJUU1JUFEJUE2JUUzJTgxJUI2JUVGJUJDJTg4TnVtUHklRTMlODIlQjklRTMlODIlQkYlRTMlODIlQTQlRTMlODMlQUIlRUYlQkMlODkmdHh0LWFsaWduPWxlZnQlMkN0b3AmdHh0LWNvbG9yPSUyMzIxMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT01NiZzPThhMGJmMmI1MzM2NDVlNDBlM2UyZGZjNDg1NGJmNTlj%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBzaW1vbnJpdGNoaWUmdHh0LWNvbG9yPSUyMzIxMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT0zNiZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZzPTAzNTFhOWFiMzVlNjQwNDIxNzY0MDEzZTMzZTZhNmZk%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3D2c9035999f00da0029accbe8604c4563)
GoogleスタイルのPython Docstringの入門 - Qiita
前置き 本記事では、Googleスタイル形式でのPython Docstringの書き方について必要最低限に絞って説明する。 これから、Python Docstringを覚えようとしているエンジニアの参考になれば、幸いである。 Python Docstringとは Pythonにおけるクラスや、メソッド(関数)についての説明を記載したコメント文のこと。 Docstringは、__doc__という変数に格納されている。 以下は、printメソッドのDocstringを表示させたもの。 >>> print(print.__doc__) print(value, ..., sep=' ', end='\n', file=sys.stdout, flush=False) Prints the values to a stream, or to sys.stdout by default. Opti
なぜ読みやすいコードが必要なのか - コードの可読性を高める手法をサンプルで学ぶ - エンジニアHub｜Webエンジニアのキャリアを考える！
なぜ読みやすいコードが必要なのか - コードの可読性を高める手法をサンプルで学ぶ システム開発会社「アクシア」の代表として、自社・他社含め、さまざまなエンジニアのコードを読んできた米村歩さん。そんな米村さんの持論は、「コードの可読性は生産性に多大な影響を与える」ということ。可読性の低いコードはどんな弊害をもたらし、どうすれば改善できるのか――。チーム開発を効率化するコードの「可読性」について綴っていただきました。 プロフェッショナルのエンジニアには、「可読性」の高いコードを書くスキルは必要不可欠です。単に目的とする処理が実行できればよいわけではありません。しかし実際の開発業務の中では、可読性は意外と軽視されてしまいがちです。 経験の浅い駆け出しのエンジニアにとっては、可読性の重要さを肌感覚で理解するのは難しいかもしれません。また、新人エンジニアに対してプログラミング言語や開発ツールについて
冗長な表現
何気なく使われている言葉に、違和感を覚えることはありませんか？ 例えば、 100円割引致します。 極めて有効的だといえる。 などは、冗長な表現だと言えます。 何故かというと… 1. 「１割引き」では値段の１割が減額されるのに対し、「100円割引」で減額されるのはもとの値段に関係なく100円。 よって、「割」という語は不要であり、「100円引き」と表現するのが正確です。 ちなみに、「15%割引き」も、正しくは「15%引き」とすべきでしょう。 2. 「的」という語は、名詞を形容詞的に使うため、その名詞の後に付けて使います。 この場合、「有効」というのは形容詞なので、それに「的」を付けるのは用法として誤り。(「有益的」とか「有用的」とは言いませんよね？) この場合は、単に「有効だと～」、あるいは「効果的だと～」が適当です。 コンピュータの世界でも、こうした「冗長な表現」は目に付きます。 例えば、
cpplint でコーディングチェック
Google Style Guides のチェックツールとして cpplint.py があります。 今回はこれを使って iutest のコーディングスタイルをチェックしてみました。 cpplint.py の使い方cpplint.py は github から取得できます。クローンしてもいいですし、cpplint.py だけダウンロードしても OK です。 https://github.com/google/styleguide iutest の場合 1行の文字数やスペース、改行の入れ方などの報告のほかに、explicit を付けましょうとか const 参照にしましょうなどの報告も出ました。 チェック内容チェックされる内容は以下のものがあります。
2016年、C言語はどう書くべきか (前編) | POSTD
(訳注：2016/3/2、いただいた翻訳フィードバックをもとに記事を修正いたしました。) (訳注：著者のMattより、「本文中で明言はしていないが、この記事の内容はx86-64 Unix/Linux/POSIXでアプリケーションをプログラミングする場合にフォーカスしている。他のプログラミング領域では、対象とするシステムに応じた(例： 8-bitの組み込みシステム、10年前のコンパイラ、多くの異なるCPUアーキテクチャで動く必要のあるアプリケーション、Win/Linuxでのビルド互換性など)特有のアドバイスが必要」との補足を頂いております。) 以下の文章は2015年の始めに書いたドラフトで、今まで公開していませんでした。私のドラフト用フォルダの中で誰の目も引かなかったため、大部分が書いた時のままです。公開するにあたり、単純に2015年を2016年に変更しました。 必要な修正、改善、苦情があり
Semantic Versioning 2.0.0
english セマンティック バージョニング 2.0.0 概要 バージョン番号 MAJOR.MINOR.PATCH を前提として、 あなたが互換性のない API の変更を行うときに MAJOR バージョンを、 後方互換性のある方法で機能性を追加したときに MINOR バージョンを、 そして、後方互換性のあるバグ フィックスをしたときに PATCH バージョンを、 インクリメントします。 追加のラベルとして、プレリリースとビルド メタデータが MAJOR.MINOR.PATCH フォーマットへの拡張として利用することができます。 序論 ソフトウェア マネジメントの世界には「依存関係地獄」と呼ばれる非常に恐ろしい場所が存在します。 あなたのシステムがより大きくなるほど、あなたのソフトウェアの中へより多くのパッケージを溶け込ませるほど、いつかこの絶望の底にいるあなた自身に気づく、そんな可能性が
プロとしての行為 Act as Proffesional
Gitのブランチをどのタイミングで切って、マージしていくかなども非常に大切ですが、ブランチやマージをするよりも頻繁におこなうコミットについて、あらためて基本に立ち返ってみましょう。 一つ一つのコミットを綺麗に積み重ねていくことは、ブランチを切るタイミングやマージ、歴史の改編などを容易にすることができます。コミットが綺麗に積み重ねられていないとマージや歴史改変で苦労するでしょう。 Gitのベストプラクティス（原文）に乗っかるためにもgit commitする前に以下のようなことをチェックしましょう。 Gitの操作に慣れている人はPushやMergeをする前に今回紹介するようなことを元にしてコミットの歴史を綺麗に整えましょう。 1コミットに1つの対応1コミットにはあれこれ詰め込めすぎるべきではありません。例えば以下のような2つのことがあったとします。 Aの機能を追加Bの機能のバグを修正2つの対応
米国人からコーディングについての怒りのメールを頂戴した - その手の平は尻もつかめるさ
"米国人からコーディングについての怒りのメールを頂戴した" の補足 - その手の平は尻もつかめるさ ↑の方で補足いたしました。(2012.09.04 追記) 最近、英語のメールでよく怒られます。moznion です。 海を隔てて共同作業しているアメリカ人から、僕のコーディングについてお叱りのメールを頂いたので、 自戒の念を込めて邦訳して記します。 書いてあることは「当然」とも言うべき内容ですが、僕はその「当然」も守れていなかったのかぁ〜と反省。 以下、邦訳(意訳)です。 1. 郷に入っては郷に従え 既にソースコードが存在しているって事は、そこには同時にコーディングスタイルも存在しているってことだ。 その既存のソースコードに手を加える場合、別のコーディングスタイルを導入してはならない。 もし君がバックエンドのソースコードを弄っているなら、バックエンドのコーディングスタイルで記述するんだ。 フ
Python の Coding Style あれこれ - Study08.net 対シンバシ殲滅用人型機動兵器
唐突ですが、Python の Coding Style について参考になりそうなものをまとめてみるテスト。 主にベースとなるPEP8の他に、僕が見聞きしたWebフレームワークのCoding Styleを列挙しています。 PEP 8 Style Guide for Python Code http://www.python.org/dev/peps/pep-0008/ (和訳) http://oldriver.org/python/pep-0008j.html PEP 8 は Pythonを書く上で大体みんなが参考にするCoding Styleです。以下にあげる Coding Style達は、PEP8 に従い、その中で独自のCoding Styleを定義しているものがほとんどです。 PEP が初耳という人は、下記エントリーが参考になるでしょう。 http://www.oreilly.co.j
Pep8 and pyflakes in emacs - Reinout van Rees
Pep8 and pyflakes in emacs¶ Tags: python, emacs Pep8 checks your python code for common formatting fixes. Pyflakes checks your syntax, your imports, etcetera. Indispensable tools, so they should be easy to use. If you don’t have them yet, do a simple easy_install pep8 and easy_install pyflakes and you’ve got them. Then call either pep8 or pyflakes on a python file or on a directory to get an error
http://www.python.jp/doc/contrib/peps/pep-0257.txt
PEP-JP: 257 オリジナルのヘッダ ================== PEP: 257 Title: Docstring Conventions Version: $Revision: 1.1.1.1 $ Last-Modified: $Date: 2003/03/19 01:15:10 $ Author: David Goodger , Guido van Rossum Discussions-To: doc-sig@python.org Status: Active Type: Informational Content-Type: text/x-rst Created: 29-May-2001 Post-History: 13-Jun-2001 概要 ==== この PEP ドキュメントでは，様々な Python ドキュメンテーション文字列 (docstring) につ
PASSPORT_ヘボン式ローマ字綴方表
本表及びその他用法で注意すべき点 ■撥音 「ん」は「Ｎ」で表記する。 かんの ＫＡＮＮＯ ほんだ ＨＯＮＤＡ Ｂ・Ｍ・Ｐの前では、「ん」は「Ｍ」で表記する。 なんば Ｎ Ａ Ｍ Ｂ Ａ ほんま Ｈ Ｏ Ｍ Ｍ Ａ まんぽ Ｍ Ａ Ｍ Ｐ Ｏ ■促音 「っ」は子音を重ねる。 べっぷ Ｂ Ｅ Ｐ Ｐ Ｕ いっしき Ｉ Ｓ Ｓ Ｈ Ｉ Ｋ Ｉ Ｃ Ｈの前では、「っ」は「Ｔ」で表記する。 えっちゅう Ｅ Ｔ Ｃ Ｈ Ｕ はっちょう H A T C H O ■長音 長音表記又はヘボン式によらない表記を希望するときは、申請添付書類ダウンロードページから「非ヘボン式ローマ字氏名表記等申出書（様式1）」をダウンロードし、必要事項を記入した上で、東京都の旅券窓口にご相談ください。 → 申請添付書類ダウンロード
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
「プライマリ」「セカンダリ」の次は？ - キーワードノート
The W3C Markup Validation Service
Pythonコーディング規約
https://oldriver.org/python/pep-0008j.html
GNU コーディング規約