wikiotics.org
1.0.0
Wikiotics는 외국어를 배우기위한 웹 사이트입니다.
Wikiotics Project는 2008 년에 사람들이 언어 학습자를위한 자료에 대해 협력 할 수있는 자유롭게 허가 된 Wiki를 만들기 위해 설립되었습니다. 이의 일부로, 우리는 Ductus라는 Wiki 엔진을 구축하여 웹 브라우저에서 편집 할 수있는 구조화 된 컨텐츠에서 대화식 위키 페이지를 구축하기위한 프레임 워크를 제공했습니다. 2011 년 Wikiotics는 비슷한 비전을 가진 프로젝트 인 Wikibabel Project와 힘을 합쳤습니다. 몇 년 후, 우리는 덕스 유지에 대한 관심을 잃었고 다른 활동에 점령되었습니다.
2020 년 7 월 현재 Wikiotics는 정적 사이트로 전환되었습니다. Wiki 이었지만 Wikiotics.org는 62 명의 로그인 사용자와 IP 주소로만 식별 된 익명 사용자로부터 기부금을 받았습니다. 이러한 기부금은 총 4064 개가 있었는데, 각 기부금은이 저장소에 해당 커밋을 갖습니다 (풀 요청 #4). 이 저장소는 커뮤니티 작업의 작업 보관소 역할을하도록 설계되었습니다. 충분한 관심이 주어지면 새로운 콘텐츠의 개발도 가능합니다.
콘텐츠는 전 세계 누구든지, 완화없이 편집 할 수있는 저장소에서 기대할 수 있듯이 콘텐츠는 약간 엉망입니다. 게다가, 수업의 작업 초안을 보는 유일한 방법은 위키에 저장하는 것이 었습니다.
첫 번째 단계는 내용을 정리하는 것입니다. 유용하지 않은 레슨과 페이지를 삭제해야합니다. (우리가 그들을 참조하고 싶다면 그들은 git 역사에 남아있을 것입니다.) 아직 유용하지 않은 모든 교훈은 draft = true 로 표시되어 기본 웹 사이트 빌드에 숨겨져 있습니다. 동일한 콘텐츠의 여러 사본이 통합되면 Cool Uris가 변하지 않는 원칙을 오랫동안 따랐으므로 별명은 오래된 위치에 남겨 두어야합니다.
위키에 기여하고 GitHub에 계정이있는 사람은이 리포지토리에서 .mailmap 파일에 적절한 항목을 추가하는 풀 요청을 제출함으로써 기부금을 청구 할 수 있습니다. 이 항목은 [email protected] 개인의 GitHub 계정 (또는 주소 [email protected] )과 관련된 이메일 주소에 매핑해야합니다.
이러한 방식으로 기여를 주장하면 사용자의 프로필이 사람이 기여한 모든 페이지의 Github 기록에 연결되어 있음을 의미합니다 (예 : 여기). 불행히도 현재, 기여 그래프는 .mailmap 파일을 고려 하지 않는 것 같습니다. 이것은 스택 오버플로에 대한 보고서와 일치하지 않지만 Github의 담론 사례에 대한이 논의와 관련이있을 수 있습니다. 흥미롭게도, Fasthub-Libre 앱은 기여 그래프를 전체적으로 올바르게 표시합니다.
Wikiotics는 이제 Hugo와 함께 제작 된 정적 사이트입니다. 다음 단계를 통해 로컬로 편집 할 수 있습니다.
휴고를 설치하십시오.
우분투에서 이것은 간단합니다
$ sudo snap install hugo --channel=extended
현재 "확장 된"버전은 필요하지 않지만 향후 기능을 실험 할 수 있습니다.
이 저장소를 복제하십시오.
$ git clone https://github.com/wikiotics/wikiotics.org.git
Hugo Development Server를 시작하고 웹 브라우저를 제공된 URL로 가리 킵니다.
$ cd wikiotics.org
$ hugo server
[...]
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
내용은 content/ 디렉토리에 있습니다. 컨텐츠 파일을 저장하면 웹 브라우저는 업데이트 된 컨텐츠로 자동으로 새로 고침해야합니다.
각 수업은 전적으로 Toml Front Matter로 표시되며, 여기에는 +++ 표시되는 줄 사이에 포함되어 있습니다. 레슨을 편집 할 때 한 가지 팁은 전면 물질에서 grid = true 일시적으로 설정하는 것입니다. 이는 레슨 요소를 스프레드 시트로 표시합니다. 이것은 수업에 대한 전 세계적으로 볼 수있는 데 유용 할 수 있습니다. draft = true 가 그리드로 표시되는 수업 (즉, 초안이 활성화 된 경우).
각 수업은 가르치는 언어로 주석을 달 수 있으며, 해당되는 경우, 학습자 가이 용어의 표준 정의에 따라 수업의 전면 물질에서 target-languages 및/또는 source-languages 설정함으로써 알고 있다고 가정합니다. 무대 뒤에서이 주석은 휴고 분류의 사례입니다.
Wiki 이름 지정 체계 (URL/경로의 경우)는 #12에서 논의 중입니다. 또한 수업을 위해 TOML 데이터 구조를 문서화하고 (#10) 개선 할 계획입니다 (#10).
현재 가장 높은 우선 순위는 사이트 아카이브의 프레젠테이션을 개선하는 것입니다.
새로운 수업 미디어를 추가하려면 현재 Wikiotics Media Repository와의 변경 조정이 포함됩니다. 고려중인 두 가지 대안이 있습니다 : Git Large File Storage와 IPF ( #15의 세부 사항).
모든 컨텐츠 (예 : content/ 디렉토리의 모든 내용, 재귀 적으로)는 Creative Commons Attribution-Sharealike 3.0 라이센스에 따라 라이센스가 부여됩니다. 수업 미디어 중 일부 (이 저장소에 참조되었지만 포함되지 않음)는 다른 (그러나 무료) 크리에이티브 커먼즈 라이센스로 제공됩니다. 기타 모든 (예 : 모든 코드)는 GNU 일반 공개 라이센스 버전 3 또는 이후 버전에서 사용할 수 있습니다. {assets,static}/ductus/ 의 일부 라이브러리는 더 허용되는 라이센스로 제공됩니다.
우리는 수년간 복잡한 기술 스택을받은 후 일을 단순하게 유지하는 것을 좋아합니다. (이전에도, 우리는 현대적인 프론트 엔드 개발의 많은 과잉을 피할 수있었습니다.) 물건을 단순하게 유지하면 버스 계수를 극대화하고 사이트를 유지하는 데 소요되는 시간을 최소화하는 데 도움이됩니다. 움직이는 부품이 없거나 적은 것이 없어야하며 이상적으로는 유지해야 할 서버가 없습니다.
우리는 목표를 달성하기 위해 다음과 같은 기술을 기반으로합니다.
