Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

QGISマニュアル・GDAL翻訳 #2

Open
akidinosaurs opened this issue Aug 5, 2024 · 5 comments
Open

QGISマニュアル・GDAL翻訳 #2

akidinosaurs opened this issue Aug 5, 2024 · 5 comments
Assignees

Comments

@akidinosaurs
Copy link
Contributor

akidinosaurs commented Aug 5, 2024

プロジェクト概要

青山学院大学の授業「応用空間情報学Ⅲ」では、古橋研究室のゼミ生を中心に次のプロジェクトを進めています。このプロジェクトは、オープンソースの地理情報システム(GIS)であるQGISやGDALの技術文書を翻訳することを目的としています。

プロジェクトの目的

  • QGISとGDALの理解: QGISはデスクトップGISソフトウェアであり、GDALはラスタ/ベクタデータの変換と操作を行うライブラリ/コマンドラインツールです。本プロジェクトでは、これらの技術文書の翻訳を通じて、その機能を理解します。

  • 翻訳手法の習得: 英語の技術文書を翻訳する方法を学びます。また、インターネット上での文書公開や共有の仕組み、国際化の方法例を学習し、その利用方法を理解します。

  • コミュニティ活動の理解: オープンソースソフトウェアの開発・利用者コミュニティの活動について学びます。

プロジェクトの活動内容

  1. 準備段階:

    • QGIS/GDALの基本機能を解説し、簡単な操作を実習します。
  2. 技術文書の翻訳:

    • 技術文書がどのようなフレームワークを利用して作成されているかを解説します。
    • 翻訳作業用ツールの利用方法を学び、参加者で翻訳作業を分担します。
  3. 中間および最終発表:

    • 翻訳結果や文書作成時の問題点・疑問点を中間発表・最終発表でプレゼンテーションし、参加者間でレビューを行います。
    • 翻訳の品質を向上させ、最終的な公開文書を作成します。
  4. ソフトウェアの利用体験:

    • GitHubを利用してマークダウン形式で文書を作成・公開し、共同編集する体験を通じて、方法を理解します。
    • デジタル文書作成・公開用フレームワークであるSphinxの操作を習得します。
  5. デジタル空間情報に関する英語スキルの向上:

    • デジタル空間情報関連のデータ操作についての英単語や英文の読解に慣れることを目指します。

プロジェクトで学ぶこと

  • Transifexの利用方法: 翻訳作業用WEBサービスTransifexの利用方法を理解します。

  • Sphinxの理解: デジタル文書公開・共有用のフレームワークSphinxの仕組みと国際化機能について学びます。

  • GitHubの活用: GitHubでマークダウン形式の文書を作成・公開し、共同編集する方法を理解します。

  • オープンソース活動の体験: オープンソースソフトウェアの開発、維持、普及活動の一部を体験します。

このプロジェクトを通じて、オープンソースの空間情報操作プログラムの知識を深め、翻訳技術と国際化のスキルを身につけることを目指します。


@akidinosaurs akidinosaurs changed the title QGIS翻訳 QGISマニュアル・GDAL翻訳 Aug 5, 2024
@akidinosaurs akidinosaurs self-assigned this Aug 5, 2024
@akidinosaurs
Copy link
Contributor Author

akidinosaurs commented Aug 5, 2024

Project Overview

In Aoyama Gakuin University's course "Applied Geospatial Information Science III," students from the Furuhashi Lab are leading a project focused on translating technical documents for open-source geographic information systems (GIS) like QGIS and GDAL.

Project Goals

  • Understanding QGIS and GDAL: QGIS is a desktop GIS software, and GDAL is a library/command-line tool for raster/vector data conversion and manipulation. Through the translation of these technical documents, the project aims to understand their functionalities.

  • Learning Translation Techniques: The project involves learning how to translate English technical documents. It also covers understanding the methods for publishing and sharing documents online and examples of internationalization.

  • Understanding Community Activities: Learn about the activities of the development and user communities of open-source software.

Project Activities

  1. Preparation Stage:

    • Explain the basic functions of QGIS/GDAL and conduct simple operational exercises.
  2. Translation of Technical Documents:

    • Explain the frameworks used to create technical documents.
    • Learn how to use translation tools and divide translation tasks among participants.
  3. Interim and Final Presentations:

    • Present translation results, issues, and questions during interim and final presentations, and conduct reviews among participants.
    • Improve translation quality and create the final published document.
  4. Software Usage Experience:

    • Use GitHub to create, publish, and collaboratively edit markdown documents, gaining an understanding of the process.
    • Learn to operate Sphinx, a framework for creating and publishing digital documents.
  5. Improving English Skills Related to Digital Spatial Information:

    • Aim to become familiar with English vocabulary and comprehension related to data manipulation in digital spatial information.

Learning Objectives

  • Using Transifex: Understand how to use the web service Transifex for translation work.

  • Understanding Sphinx: Learn about the framework Sphinx for digital document publishing and sharing, including its internationalization features.

  • Utilizing GitHub: Understand how to create, publish, and collaboratively edit markdown documents on GitHub.

  • Experiencing Open Source Activities: Experience part of the development, maintenance, and dissemination activities of open-source software.

Through this project, we aim to deepen our knowledge of open-source spatial information manipulation programs and acquire translation and internationalization skills.


@akidinosaurs
Copy link
Contributor Author

Abstract

Title: Localization of FOSS4G Tools and Building an Open Knowledge Platform in Japanese University Education

In the rapidly evolving field of geospatial technology, access to comprehensive and understandable documentation is vital for both new and experienced users. However, language barriers often limit access to valuable resources. Our project, conducted under the "Applied Geospatial Information Science III" course at Aoyama Gakuin University, aims to bridge this gap by localizing technical documents for Free and Open Source Software for Geospatial (FOSS4G) tools such as QGIS and GDAL. These tools are widely used for geospatial data manipulation, analysis, and visualization, yet much of their documentation remains predominantly in English. By translating these documents into Japanese, we aim to increase accessibility and foster a deeper understanding of geospatial technologies among Japanese-speaking users.

Our approach begins with a thorough understanding of QGIS and GDAL's functionalities, followed by hands-on exercises to familiarize participants with basic operations. This practical experience serves as a foundation for translating the technical documents, allowing participants to contextualize the content effectively. We employ tools such as Transifex for collaborative translation efforts, ensuring consistency and accuracy across translated materials.

The project also emphasizes the significance of open-source software communities. Participants are introduced to the collaborative nature of these communities, learning how user contributions enhance software development and maintenance. This aspect of the project not only highlights the technical skills required for translation but also the importance of community engagement in the open-source ecosystem.

Additionally, our project extends beyond translation by building an open knowledge platform. Utilizing GitHub, participants create, edit, and publish markdown documents, simulating real-world collaborative environments. This experience equips them with the skills needed to manage digital documentation effectively and fosters a culture of open knowledge sharing within the academic community.

We further explore the capabilities of Sphinx, a documentation generation tool, to publish our translated materials. By leveraging Sphinx's internationalization features, we ensure that our translations maintain the quality and structure of the original documents.

This project demonstrates how localization and open knowledge platforms can serve as gateways to greater geospatial literacy, bridging the gap between technology and language. By presenting our findings and methodologies at this international conference, we hope to inspire similar initiatives worldwide, contributing to a more inclusive geospatial community that transcends linguistic barriers.


@akidinosaurs
Copy link
Contributor Author

akidinosaurs commented Aug 5, 2024

Abstructの和訳

タイトル: 日本の大学教育におけるFOSS4Gツールの多言語化とオープンナレッジプラットフォームの構築

急速に進化する地理空間技術の分野では、新規ユーザーと経験豊富なユーザーの両方にとって、包括的で理解しやすいドキュメントへのアクセスが重要です。しかし、言語の壁が貴重なリソースへのアクセスを制限することが多々あります。青山学院大学の「応用空間情報学Ⅲ」講座で行われた我々のプロジェクトは、QGISやGDALなどのFOSS4G(Free and Open Source Software for Geospatial)ツールの技術文書を多言語化することで、このギャップを埋めることを目的としています。これらのツールは地理空間データの操作、分析、可視化に広く使用されていますが、その多くのドキュメントは主に英語で提供されています。これを日本語に翻訳することで、日本語話者のユーザーに対するアクセスを増やし、地理空間技術の理解を深めることを目指しています。

我々のアプローチは、まずQGISとGDALの機能を徹底的に理解し、その後、参加者が基本的な操作に慣れるための実践的な演習を行います。この実践的な経験は技術文書の翻訳の基盤となり、参加者がコンテンツを効果的に理解するのを助けます。私たちはTransifexなどのツールを使用して協力翻訳を行い、一貫性と正確性を確保しています。

プロジェクトでは、オープンソースソフトウェアコミュニティの重要性も強調しています。参加者はこれらのコミュニティの協力的な性質を理解し、ユーザーの貢献がどのようにソフトウェアの開発と保守に寄与するかを学びます。このプロジェクトの側面は、翻訳に必要な技術的スキルだけでなく、オープンソースエコシステムでのコミュニティエンゲージメントの重要性も強調しています。

さらに、翻訳だけでなく、オープンナレッジプラットフォームを構築することにも取り組んでいます。GitHubを利用して、参加者がマークダウン形式のドキュメントを作成、編集、公開し、実際のコラボレーション環境をシミュレートします。この経験は、デジタルドキュメントを効果的に管理するために必要なスキルを参加者に提供し、学術コミュニティ内でオープンナレッジシェアリングの文化を育みます。

我々は、翻訳した資料を公開するために、ドキュメント生成ツールであるSphinxの機能も探ります。Sphinxの国際化機能を活用することで、翻訳が元の文書の品質と構造を維持できるようにします。

このプロジェクトは、多言語化とオープンナレッジプラットフォームが、技術と言語のギャップを埋め、より安易な地理空間情報リテラシー醸成への入り口としての機能をつくることにつながります。FOSS4G国際会議にて、このプロジェクトを共有し、地理空間コミュニティへの貢献を目標にしています。


@akidinosaurs
Copy link
Contributor Author

@akidinosaurs
Copy link
Contributor Author

akidinosaurs commented Sep 9, 2024

description

QGIS translation manual

The "QGIS Documentation Japanese Translation Manual 2024" is an in-depth guide created by the Furuhashi Lab to support students and participants in translating QGIS Desktop user guides into Japanese using Transifex. QGIS, a widely used open-source GIS software, often has documentation primarily available in English, creating a language barrier for Japanese users. This manual addresses these challenges by providing step-by-step instructions on how to use Transifex, a translation management platform commonly adopted by open-source projects.

The manual begins by explaining the importance of QGIS's internationalization efforts (i18n) and why Japanese translations are crucial for expanding accessibility. It details the account registration process on Transifex, highlighting potential pitfalls and solutions, such as using GitHub to bypass certain registration restrictions. Additionally, the guide includes best practices for project participation and managing translation workflows to ensure high-quality outputs.

A key feature of the guide is its emphasis on collaboration through GitHub. By leveraging GitHub, participants can document their work, share insights, and address common issues encountered during translation. The GitHub repository serves as an open knowledge platform, encouraging participants to engage in discussions, post FAQs, and create markdown documents that simulate real-world collaboration. This environment helps both beginners and experienced users alike to enhance their skills, providing a hands-on learning experience that goes beyond traditional classroom instruction.

The manual also follows the JTF’s “Translation Guidelines,” ensuring that the translation efforts meet professional standards, particularly when dealing with open data. It breaks down the specific steps involved in translating QGIS documentation, including how to navigate po files within GitHub, a critical component for managing translations in GDAL. The guide also provides troubleshooting tips and common solutions, helping users maintain consistency and accuracy across all translated materials.

Furthermore, the manual explores the use of Sphinx, a documentation generation tool, which helps in publishing the translated documents while maintaining their original structure and quality. The Sphinx internationalization features are particularly highlighted, demonstrating how translated content can be managed effectively within a professional framework.

Overall, this project aims to bridge the language gap in geospatial technology by creating a comprehensive resource that supports the Japanese translation of essential QGIS documentation. By fostering an open knowledge-sharing culture, the initiative empowers students and participants to contribute meaningfully to the broader geospatial community. The project’s ultimate goal is to present these efforts at the FOSS4G International Conference, showcasing the impact of localization and collaborative learning on enhancing geospatial literacy for Japanese-speaking users.

For a complete guide and more details, please visit the page here.

GDAL translation

GDAL (Geospatial Data Abstraction Library) is a versatile library and command-line tool used for converting and manipulating raster and vector data. It supports a wide range of geospatial data formats and is essential for data conversion, processing, and analysis in various GIS applications. The translation rules for GDAL documentation are aligned with those established for QGIS, ensuring consistency across these geospatial tools. GDAL translations are managed using po files on GitHub, facilitating collaborative updates and refinements. This approach allows contributors to work together efficiently, ensuring the documentation remains accurate and relevant.

By managing translations on GitHub, the GDAL community leverages version control, making it easier to track changes, address errors, and maintain high standards of quality across all translated content. This process enhances accessibility for Japanese-speaking users, promoting broader use of GDAL in academic, professional, and research environments. The GitHub repository serves as an open platform for sharing translation progress, encouraging community engagement, and providing a centralized location for all translation-related activities. This collaborative effort ensures that GDAL's powerful features are accessible to a wider audience, contributing to the overall growth and understanding of geospatial technology in different languages.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant