본문 바로가기
[ios/tutorial] Xcode 에서 주석을 통해 Documenting 하는 방법 [ios/tutorial] Xcode 에서 주석을 통해 Documenting 하는 방법 http://www.raywenderlich.com/66395/documenting-in-xcode-with-headerdoc-tutorial -Documenting 을 header 에 하는 것이 맞을까 implementation 에 하는 것이 맞을까 검색하던 중 좋은 자료를 찾아서 정리해보았다. -더 많은 디테일한 정보를 얻고 싶다면, 상단에 링크된 원문을 읽는 것이 추천된다. -HeaderDoc 이라는 녀석이 있는데, Xcode5 & iOS7 과 함께 발표된 추가기능이다.이 녀석은 command line tool 인데, code 에 있는 document 를 HTML 형태로 만들어준다.( 물론 지원하는 형태로 작성했.. 2017. 11. 16.
[ios] UIView 에 대한 이야기 [ios] UIView 에 대한 이야기 참조 : https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIView_Class/ -UIView 는 다른 View 를 가질 수 있다. -보통 Subview 는 superView 의 bound 에 clip 되지 않지만 clipsToBounds property 를 사용하면 clip 시킬 수 있다. -view 의 geometry 는 frame, bounds, 그리고 center property 에 의해 결정된다.frame 은 superview 기준의 position 과 size 를 결정할 때 사용된다.center 는 size 변화 없이 position 변경할 때 사용된다.bounds 는 view.. 2017. 11. 10.
[Kotlin Tutorial] Documenting Kotlin code [Kotlin Tutorial] Documenting Kotlin code 출처 : Kotlin in action 1. Writing Kotlin documentation comments -Java 의 Javadoc 만들 때와 비슷하다.Kotlin 의 것은 KDoc 이라 부른다. -KDoc 은 /** 로 시작하고 tag 는 마찬가지로 @ 로 시작한다.Javadoc 과의 가장 큰 차이가 있다면 HTML 대신 Markdown 을 사용한다는 것이다./** * Calculates the sum of two numbers, [a] and [b] */fun sum(a: Int, b: Int) = a+b 정의를 참조하려면 [ ] 안에 이름을 넣어주면 된다. cf) Markdown 은 text-to-HTML conve.. 2017. 9. 20.
[Effective Java] 메소드가 던지는 모든 예외를 문서화하자. [Effective Java] 메소드가 던지는 모든 예외를 문서화하자. - Javadoc 의 @throws 태그를 사용해서 항상 checked 예외는 별도로 선언하고, 각 예외가 발생하는 상황을 정확하게 문서화하자. 메소드가 던지는 예외가 많다고 해서 메소드 명세에 각 예외를 정확하게 선언하지 않고, 그 예외 클래스의 대표적인 슈퍼 클래스만 함축해서 나타내면 안 된다. - unchecked 예외의 문서 내역은 메소드가 성공적으로 실행되기 위한 사전조건(precondition)을 효과적으로 나타낸다. - 인터페이스에 정의된 메소드의 경우 자신이 던질 수 있는 unchecked 예외를 문서화하는 것이 "특히" 중요하다. 그 인터페이스의 보편적 계약 중 일부분이 되며, 인터페이스를 구현하는 여러 구현체들 간의.. 2017. 2. 28.
[기초강좌] HTML Lists - w3schools 번역 [기초강좌] HTML Lists - w3schools 번역 w3school 의 강좌 내용을 번역한 글입니다. 원문 : http://www.w3schools.com/html/html_lists.asp 가장 흔하게 쓰이는 HTML list 는 정렬된 리스트( 원문 : ordered list ) 와 정렬 안된 리스트 ( 원문 : unordered list ) 이다. HTML Unordered Lists 정렬되지 않은 list 는 tag 로 시작된다. 각 리스트 아이템은 tag 로 정의된다. 리스트 아이템은 작은 동그라미 ( 원문 : bullet ) 로 표시된다. CoffeeMilk CoffeeMilk HTML Ordered Lists 정렬된 리스트는 tag 로 시작된다. 각 리스트 아이템은 tag 로 정의된다.. 2014. 3. 17.
[기초강좌] HTML Tables - w3schools 번역 [기초강좌] HTML Tables - w3schools 번역 w3school 의 강좌 내용을 번역한 글입니다. 원문 : http://www.w3schools.com/html/html_tables.asp HTML Tables 테이블은 tag 로 정의된다. 테이블의 행( 원문 : row ) 은 tag 로 정의된다. ( tr 은 table row 의 약자 ) 행의 셀( 혹은 열 ) 은 tag 로 정의된다. ( td 는 table data 의 약자 ) 행은 heading 으로 구분될 수도 있는데 이는 tag 를 사용한다. ( th 는 table heading 의 약자 ) elements 는 테이블의 데이터를 표시하는 곳이다. element 는 텍스트, 이미지, 리스트, 다른 테이블 등을 담을 수 있다. 테이블의.. 2014. 3. 13.
Bootstrap All Functions #1 Bootstrap All Functions #1 Container, Row, SpanX Responsive Web Typography -기본 tag 들에 대해서도 style 이 적용되어 있다. - blockquote 의 경우 위와 같이 두드러지게 바뀐다. -기본 tag 의 style 을 제거하려면 class="unstyled" 를 적용한다. -dl 의 경우 class="dl-horizontal" 로 수평 definition list 를 사용할 수 있다. Glyphicon User -Glyphicon customize pagehttp://www.w3resource.com/twitter-bootstrap/3/glyph-customization.html Table Forms Search -bootstrap 의.. 2014. 3. 13.
[기초강좌] HTML Styles - CSS - w3schools 번역 [기초강좌] HTML Styles - CSS - w3schools 번역 w3school 의 강좌 내용을 번역한 글입니다. 원문 : http://www.w3schools.com/html/html_css.asp CSS ( Cascading Style Sheets ) 는 HTML element 들을 스타일링 하는 데 사용된다. Styling HTML with CSS CSS 는 HTML 4 와 함께 소개된 것으로, HTML element 들을 더 나은 방법으로 스타일링 하는 데 사용된다. CSS 는 다음과 같은 방법으로 HTML 에 추가될 수 있다.* Inline - style 속성을 이용하여 HTML element 에 표기된다.* Internal - External Style Sheet External Sty.. 2014. 3. 11.
[기초강좌] HTML Comments - w3schools 번역 [기초강좌] HTML Comments - w3schools 번역 w3school 의 강좌 내용을 번역한 글입니다. 원문 : http://www.w3schools.com/html/html_comments.asp 주석 tags 는 으로 구성된다. HTML Comment Tags HTML 소스에 다음과 같은 법칙으로 주석을 추가할 수 있다. 주의 : opening tag 에는 ! ( 느낌표 ) 가 있지만, closing tag 에는 없다. 주석은 브라우저에 의해 표시되지는 않는다. 하지만 HTML 을 문서화 하는데 좋다. 주석을 통해 HTML 에 알림이나 메세지를 넣을 수 있다. This is a paragraph. 눈으로 직접 보기 주석은 HTML 을 디버깅하는데도 좋다. 왜냐하면 HTML 의 몇몇 라인을 .. 2014. 3. 4.
반응형