[DesignWithFontforge.com](http://designwithfontforge.com) ======================= This is a book project, about how to design new typefaces with FontForge. After you read [designwithfontforge](http://designwithfontforge.com/), you may have more user related questions on the book, fonts, or how to use FontForge. If yes, you may be interested in using the [FontForge Users mailing list](https://sourceforge.net/p/fontforge/mailman/fontforge-users/) which is an excellent place to find prior information, ask questions, or discuss more about these topics. If you are interested in improving this book project, then we have more information below. ## How To Contribute If you wish to contribute to this website, you are very welcome to! Here are a few ways you can do so: 1. Report an issue for someone else to resolve, by clicking the ‘Issues’ button at the top of [this page](http://github.com/fontforge/designwithfontforge.com), in the main navigation bar. 2. Contribute a change directly, by forking it on GitHub and editing the plain text files, then send a pull request. (If that sounds unfamiliar, [learn how with GitHub’s excellent interactive introduction](https://help.github.com)). We have also created a [short and snappy HowTo](https://github.com/fontforge/designwithfontforge.com/issues/253) which can also help you get quickly started. 3. Discuss general topics on the [fontforge-devel email discussion list](https://sourceforge.net/p/fontforge/mailman/fontforge-users/) ## Book License The book and this site are licensed under the [Creative Commons Attribution-ShareAlike 3.0 Unported License](http://creativecommons.org/licenses/by-sa/3.0/). ## How This Site Is Made This site is made with the [Jekyll](http://jekyllrb.com/docs/home/) content management system, and hosted on [GitHub pages](http://pages.github.com). If you’re not familiar with GitHub, they have [excellent help pages](https://help.github.com). #### Directory Layout - `_layouts/*.html`: HTML template files - `_includes/*.html`: snippets of HTML that are included in pages and templates - `assets/`: CSS, JS and (some) image files - `_config.yml`: Configuration for Jekyll (ignore this file) - `en-US/`: the site’s contents, in US English (default) - `en-US/images/precompressed/`: Directory of the original, pre-compressed content images #### File Formats Each page is in Markdown format, with a `.md` file extension. These files are converted into corresponding `.html` files by Jekyll when they start with these lines: - published: if the page should not be published, set this to `false` - layout: `bookpage` is the default - weight: an integer value starting from 1 that affects the ordering of the page in the sidebar and homepage lists - category: the category the page belongs in - title: the page title used in the title tag and h1 of the page Example: ``` --- published: true layout: bookpage category: Workflow weight: 3 title: Page Title --- ``` #### Weight List Weight lists are used to help contributors determine and document the weight of all pages. Please follow the following rules: 1. Please update the according list if any chapter/page is added or removed. 2. If the new chapter is in between existing chapters, Just add a weight between existing weights. 3. If the new chapter is after any existing chapters, Add the weight number by 3. 4. If no more full numbers can be added between the existing weights, start using decimals. 5. Only edit the weight list for your chapter's language. Example: | Weight | Page | |--------|--------------------------------------------| | 0 | Index | | 1 | Introduction | | 3 | What Is a Font | #### How To Build The Site For Linux, ensure that ruby-dev is installed on your system: e.g. for Ubuntu 24.04: ```bash sudo apt-get install ruby-dev ``` Next, install Jekyll: ```bash sudo install jekyll ``` To see the site as it will appear after processing by Jekyll and review your edits live in a browser layout, first enter into designforfontforge.com root directory where _config.yml is located, and then run: ```bash jekyll serve --watch # or jekyll serve --livereload ``` Now browse [http://localhost:4000/](http://localhost:4000/). #### How To Compress Images With Grunt Put all the raw images inside `en-US/images/precompressed/` Make sure npm is already installed on your computer, then install all the dependencies with: ```bash npm install ``` Once the installations are done, you can go ahead to minify all the images with this Grunt command: ```bash grunt ``` Wait for Grunt to notify you, and all the compressed images will be inside `en-US/images/` ### How To Create EBooks ```bash sudo apt-get install calibre ghostscript cd ebook npm install ./create_books.sh ```