Code Monkey home page Code Monkey logo

conlanguagizer's Introduction

conLanguagizer

Documentation Status Contributor Covenant

A digital binder for you constructed language. Keep track of your conlang's phonology, orthography, and word definitions with a dictionary. Organize the rules of your language in the grammar. You can define them using the regular expression method or the more human readable cLa syntax. conLanguagizer can then apply the grammar to one or more words in the dictionary so you don't have to conjugate yourself!

Project Goals

  1. An easy-to-use and powerful tool for creating and organizing a lexicon and grammar for a conlang
  2. Fully accessible

Contributing

Thank you for wanting to help! First, please read our Code Of Conduct. Then look here for ideas on how you can contribute and how to do so.

Cloning and Running the Source Code

Whether you're looking to contribute or tinker for your own enjoyment, below are the steps to get you started.

Code Prerequisites

  • [Node.js](TODO create and link to doc on installing)
  • [yarn](TODO create and link to doc on installing)

Before you clone, navigate your terminal to the directory you want to be the parent for the project. (Aka the folder the conLanguagizer folder will live in.) Once that's done, do the following commands:

mkdir my-folder
cd my-folder
git clone https://github.com/PrettyKenobi/conLanguagizer.git .

Before you can run the app first time you'll need to run yarn build to locally install the app's dependencies and create its dependency tree. Depending on your internet's speed and your machine's connectivity this can take more than 10 minutes.

To actually run the code type yarn dev and a new window should open.

Building the Documentation

We write most of our documentation pages in reStructuredText and host them Read the Docs. Read the Docs converts (builds) these pages to html whenever we merge a PR (TODO link to info on pull requests) into any of the branches. If you edit the documentation though, you should see if it will build before you make a PR. To do this, we use the same utility Read the Docs does, called Sphinx.

Documentation Prerequisites

  • [Python 3](TODO Link to instructions under dev documentation)
  • [Sphinx](TODO Link to instructions under dev documentation)
    • Plugins: (TODO Add sphinx plugin names here and include them in requirements.txt)

Follow the steps under Cloning and Running the Source Code to clone the project. Next navigate to the documentation folder with cd './docs.

The command to build the documentation is make html.

Your terminal will display some logging output from Sphinx. If everything went well the last line will start with build succeeded. Congratulations! To explore the output insert the full path of ./_build/html/index.html into your browser's address bar.

Built with

Authors

License

MIT - See [LICENSE] for details

Acknowledgements

  • Inspired by Polyglot (TODO: link) by (TODO: lookup author)

conlanguagizer's People

Contributors

prettykenobi avatar dependabot[bot] avatar

Watchers

James Cloos avatar  avatar

conlanguagizer's Issues

Documentation for how to contribute

  • Software
    • Pull requests
    • Bug report and feature request
    • UI design
  • Documentation
    • Writing and editing
      • Bug report
      • Pull request
  • Community
    • Spreading the word
    • Chat
      • Moderating

Code of Conduct

Include

  • Note specific processes for when problems arise
    • Expectations (such as the process for disagreements that those involved aren't/can't resolve)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.