Ko:OpenHistoricalMap/Contributing

From OpenStreetMap Wiki
Jump to navigation Jump to search

오픈 히스토리컬 맵에 오신 것을 환영합니다

이 페이지는 처음 오신 분들을 위한 안내 페이지입니다. 오픈스트리트맵 (OSM)에 대해 아신다면 훨씬 더 이해하기 쉽습니다.

오픈스트리트맵 (OSM)를 해보신 적이 없으시다면

If you don't have any experience with OSM, then there are introductions and tutorials available. Editing OSM and editing OHM is so similar that the OSM tutorials are fine for learning the basics.

The basic elements are covered in Beginners_Guide_1.3.

There are some good tutorials on LearnOSM and on TeachOSM.

프로젝트

When considering starting out in Open Historical Map, it can be really helpful to think about specific projects. If you decide on a project, it's a good idea to create a page for it under Open Historical Map/Projects. In fact, you should probably visit that page and see some of the things people have chosen to do. Some projects are really large. For example, the Open Historical Map/Projects/American Civil War project is huge. As of this writing the folks working on it have chosen to focus on smaller sub projects.

It is recommended that individuals starting projects add some form of contact information, perhaps a link to their personal wiki talk page, to the project page. This facilitates coordination if others wish to get involved in these projects.

로그인

You will need to create a login for Open Historical Map (OHM). OHM does not share OSM's user database. You can use your OSM login if you like, as long as no one else has taken it.

에디터 툴

오픈 히스토리컬 맵은 오픈스트리트맵과 똑같은 에디터 툴을 사용합니다.

ID / Potlatch

인터넷 브라우저로 접속 시 사용할 수 있는 기본 에디터인 ID와 Potlatch는 OHM에서도 똑같이 바로 사용할 수 있습니다.

JOSM

설치형 에디터인 JOSM의 경우, 다음과 같은 설정이 필요합니다.

서버 설정 변경하기

JOSM에서 참고하여 불러오는 API 세팅을 OHM 서버 API 연결용 변수로 바꿔 입력해 변경해야 합니다. 해당란에 https://www.openhistoricalmap.org/api/ 를 입력해 주세요. http가 아닌 https라는 사실에 주의해 주세요. 접속 시 OHM의 사용자명과 로그인이 필요합니다.

JOSM OHM Preferences.png

인터넷 브라우저로 웹사이트 접속 후, 상단 'Edit' 버튼 옆의 드롭다운 메뉴에 보이는 'Edit with Remote Control'를 클릭해 JOSM으로 편집할 수도 있습니다. Remote Control은 JOSM 내에서 참고 불러오기를 이미 한 상태, 혹은 JOSM이 이미 실행 중인 상태에서는 진행할 수 없다는 점에 유의해 주세요. 클릭하면 Api가 자동으로 연결됩니다. 에러 발생 시 컴퓨터 운영체제의 방화벽 설정을 조정해야 할 수도 있습니다. 이 절차는 컴퓨터 환경에 따라 다릅니다.

Using an alternate Preferences file

You can set up an alternate JOSM preferences.xml file and run JOSM from the command line if you wish to avoid changing the server preferences repeatedly.

맥 / 리눅스 환경

By default JOSM puts its preferences file in a subdirectory, .josm. You can clone this directory and run JOSM from the command line. For example, copy .josm to .josm-ohm; edit the preferences.xml file and review & possibly change the settings for osm-server.auth-method, osm-server.password, osm-server.username, and osm-server.url. Once this is done, you can set up an alias in your shell profile such as:

josm-ohm='java -Djosm.home=/Users/myhomedir/.josm-ohm -jar /Users/myhomedir/JavaApps/josm-tested.jar
윈도우 환경

(need windows details)

이름 관련

For now, use OSM naming conventions, but keep in mind that local languages change over time. For example, use Dutch names in New Amsterdam rather than modern English names.

태그 관련

OpenHistoricalMap tagging is mostly the same as OpenStreetMap tagging. In fact, some tags of marginal use in OSM (such as crop=* are much more useful in OHM, where what crop is planted at a particular point in time is both known and important.

(add link to more detailed page on tags and conventions when it exists)

There are some particularly important tags, described below.

Source

source=* is used differently in OSM and OHM. The modern OSM model is to place source=* on changesets rather than on entities in the database. OHM adheres to the earlier model. If sourcing is simple then it's fine to just put a specification of the origin of the data. If sourcing becomes complex (it often does), some projects use the convention of providing a link to the OHM wiki page for the project where much more extensive detail is possible. See the Open_Historical_Map/Projects/New_York_Capital_District project page for an example of this approach.

Examples of direct links to maps

  • https://upload.wikimedia.org/wikipedia/commons/1/1d/GeneralMapOfDistancesAndHistoricCapitals.jpg
  • Ribeiro's_World_Map: https://upload.wikimedia.org/wikipedia/commons/7/74/Map_Diego_Ribero_1529.jpg
  • 1853 Mitchell Map of Asia: https://upload.wikimedia.org/wikipedia/commons/f/fc/1853_Mitchell_Map_of_Asia_-_Geographicus_-_Asia-mitchell-1850.jpg

License

Since everything in modern OSM is under the ODbL, this tag is not used there. OHM has a different concept of licensing. Entities in OHM should have the license=* tag specifying the terms and conditions associated with the entity. We prefer license=CC0 (effectively a public domain license) whenever possible, but it may not always be feasible.

You do not need to put a license=* tag on everything. Select a higher level object (a relation or a way) whenever possible.

IMPORTANT: Note that the difference in licensing approach means you cannot casually copy data from Open Street Map. So don't.

Start & End Dates

start_date=* and end_date=* are a key part of OHM tagging. The time slider feature of the main website depends on them in order to determine what to display at any point in time. They are not currently required, but but make a huge difference to the visualizations and so every effort should be made determine them. The time slider feature correctly recognizes start_date and end_date when ascribed to relations, so relations can be used to assemble pieces of features that change over time in the obvious way.

The wiki page for start_date=* has considerable detail on date formats, much of which is important to historical mapping. Issues of importance are things like inexact dates, dates pre Gregorian Calander, etc.

날짜 형식 관련 주의사항

The following note is preserved from the top level page rewrite and needs to be reviewed and compared with the format discussion on the OSM start_date=* page.

지물의 존속기간이 정확히 언제인지 잘 모른다면 연도 정도만 추가해도 됩니다. (예: 1925년 경에 지어진 건물 : start_date=1925 )

연도나 연월까지만 추가할 시, 해당 연도의 1월 1일과 12월 31일 / 그 달의 첫날과 마지막날을 기준날짜로 삼고 자동으로 적용합니다. 예컨대 start_date=1925 으로 입력했다면 1925년 1월 1일부터인 것으로, end_date=1925 로 입력했다면 1925년 12월 31일까지로 인식하고 그렇게 표시됩니다.


같은 식으로 연월일을 다음과 같이 쓸 수 있습니다.

  • 1901-01-20 (1901년 1월 20일)
  • 1902-12 (1902년 12월경)
  • 1878 (1878년경)
  • 1900..1925 (1900년경부터 1925년경까지)
  • 1900-06..1901-04-23

언제 만들어졌는지는 모르고 사라진 날짜만 알고 있다면 똑같이 그렇게만 적어도 됩니다.

  • ..1910-01-20

There are JavaScript modules for parsing these values and translating into a human readable version, and generating queries for Overpass.

Attribution

attribution=* may be used to provide attribution at any time that a license requires it, and even if the license does not. OHM is attempting to tag attribution at the object level (POIs, ways, relations) rather than at the changeset level.

위키백과

wikipedia=*는 OHM 상의 지물에 대해 관련 위키백과 문서로 링크를 걸어줄 때 사용합니다.

위키백과는 역사 관련 정보를 얻을 수 있는 훌륭한 소스입니다. OHM에 무엇을 기여해야 하는지 감이 오지 않을 때에도 참고할 만 합니다.

위키백과에 문서가 존재하는 경우에만 해당 태그를 써 주세요. 또 위키백과 내에서도 각 언어판별로 문서가 별개로 존재하므로, wikipedia=ko:한양도성 하는 식으로 언어판명을 문서명 앞에 꼭 붙여 주시기 바랍니다.

위키데이터

The wikidata=* will link your OHM data to a particular wikidata Q code. e.g. wikidata=Q6582.

Copyrights and Licenses

OHM is a bit different from OSM. Because of the differences, copying of data from OSM to OHM should NOT be done unless it can be determined that permissions are in place (e.g., if the author of the material can be identified and contacted to gain permission.)

OHM provides for mixed licenses using the license=*. Use of the CC0 license is preferred when sources allow. More information on CC0 may be found here.

Note on OSM derived data

Ss of June 2019, there is OSM-derived data in OHM and the markings on the OHM website are incorrect. The OHM community is working to address this.

조직

OHM is in a state of transition. Since it started in 2012-13, it has been a fairly informal organization. It has become clear that a more formal structure is needed and OHM will be seeking to affiliate with a larger organization in the Open Source/Open Data community. In the meantime, folks involved in the informal organization are listening, and may be found in all of the communities listed in the next section. You find they are willing and eager to talk about where things are heading.

커뮤니티

The various OHM communities are great places to get help and discuss the issues that come up in your projects.

메일링 리스트

Open Historical Map has a traditional electronic mailing list which may be found here.

트위터

@openhistmap

OSM 슬랙

OSM US hosts a Slack workspace which is open to mappers worldwide, not just mappers in the US. There are two OHM channels in it, openhistoricalmap for general discussion and opehistoricalmap-tech for wonky discussions of internal details.

Sign up for OSM-US Slack & join the OHM discussion on #openhistoricalmap.

디스코드

OSM World Discord 서버에 오픈히스토리컬맵의 채널이 존재합니다. 영어로 운영됩니다.

이 링크를 통해 해당 서버에 가입하신 뒤 #openhistoricalmap 채널로 가셔서 OHM 관련 대화에 참여하시면 됩니다.

IRC

OHM 전체 IRC입니다. 영어 채팅이 가능하신 분들만 추천드립니다.

#ohm on irc.oftc.net

페이스북

Facebook Group

레딧

subreddit