{"id":15203122,"url":"https://github.com/piyueh/gw-dissertation-class","last_synced_at":"2026-03-11T14:12:54.359Z","repository":{"id":43780500,"uuid":"459679733","full_name":"piyueh/gw-dissertation-class","owner":"piyueh","description":"LaTeX class for GW dissertation","archived":false,"fork":false,"pushed_at":"2022-12-02T20:03:13.000Z","size":1058,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-06T15:43:42.864Z","etag":null,"topics":["dissertation","george-washington-university","gwu","latex","latex-class","latex-template"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause-clear","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/piyueh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-15T17:24:57.000Z","updated_at":"2022-03-22T02:08:05.000Z","dependencies_parsed_at":"2023-01-22T23:00:07.424Z","dependency_job_id":null,"html_url":"https://github.com/piyueh/gw-dissertation-class","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/piyueh/gw-dissertation-class","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piyueh%2Fgw-dissertation-class","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piyueh%2Fgw-dissertation-class/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piyueh%2Fgw-dissertation-class/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piyueh%2Fgw-dissertation-class/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piyueh","download_url":"https://codeload.github.com/piyueh/gw-dissertation-class/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piyueh%2Fgw-dissertation-class/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30383443,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T14:10:17.325Z","status":"ssl_error","status_checked_at":"2026-03-11T14:09:37.934Z","response_time":84,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dissertation","george-washington-university","gwu","latex","latex-class","latex-template"],"created_at":"2024-09-28T04:40:54.178Z","updated_at":"2026-03-11T14:12:54.341Z","avatar_url":"https://github.com/piyueh.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"gw-dissertation-class\n=====================\n\nThis is a modernized rewrite of GW's LaTeX class for PhD dissertations. It is currently a WIP and\nwill be _officially finished_ once I also finish my dissertation.\n\n\n## Class options\n----------------\n\nThis class is derived from the standard report class, so it accepts all standard report class\noptions. Additionally, there two more class options:\n\n1. **debug**\n  \n   The `debug` class option will enable background gridlines, layout frames, and also boxes\n   surrounding hyperlinks.\n\n2. **font**\n  \n   Times New Roman is the designated font type by GW. However, we prefer STIX 2 over Times New\n   Roman. So STIX 2 is the default font in this class. Also, STIX 2 is shipped in some modern TeX\n   distributions, for example, the `texlive` in Linux.\n\n   This class also allows Palatino, URW P052 or TeX Gyre Pagella. To specify the font, use the\n   package option `font`:\n\n   * STIX 2 (default): `\\documentclass[font=STIX2]{gw-dissertation}[2021/11/19] `\n   * Times New Roman: `\\documentclass[font=Times]{gw-dissertation}[2021/11/19] `\n   * URW P052: `\\documentclass[font=P052]{gw-dissertation}[2021/11/19] `\n   * TeX Gyre Pagella: `\\documentclass[font=Pagella]{gw-dissertation}[2021/11/19] `\n   * Palatino: `\\documentclass[font=Palatino]{gw-dissertation}[2021/11/19] `\n  \n   These fonts may not be available by default on your system and require installation. For example,\n   in Arch Linux:\n   * `$ sudo pacman -S tex-gyre-fonts` installs TeX Gyre Pagella\n   * `$ sudo pacman -S gsfonts` installs URW P052\n   * Times New Roman is not open-source. It is only available in AUR packages, such as\n     [ttf-ms-fonts](https://aur.archlinux.org/packages/ttf-ms-fonts)\n   * Palatino is not open-source. It is only available in AUR packages, such as\n     [ttf-win7-fonts](https://aur.archlinux.org/packages/ttf-win7-fonts).\n  \n  The font setting only affects the non-math mode. The math mode is hard-coded to use\n  [STIX2](https://github.com/stipub/stixfonts).\n\n\n## Usage\n--------\n\nThis is a document class, not a package. Use `\\documentclass{gw-dissertation}` to use the class.\n\n### Front matter\n----------------\n\nTo configure front matter:\n\n| command | note |\n| ------- | ---- |\n| `\\title{\u003ctitle\u003e}` | |\n| `\\author{\u003cfull name}` | |\n| `\\defdate{\u003cdefense date\u003e}` | |\n| `\\gradyear{\u003cdegree deferral year\u003e}` | |\n| `\\gradmonth{\u003cdegree deferral month\u003e}` | |\n| `\\graddate{\u003cdegree deferral date\u003e}` | |\n| `\\advisor{\u003cfull name\u003e}{\u003cjob title\u003e}` | |\n| `\\school{\u003cschool\u003e}` | |\n| `\\prevdegree{\u003cprevious degree\u003e}` | see note 1 |\n| `\\committee{\u003cname, affiliation, and title\u003e}` | see note 2 |\n| `\\dedication{\u003cdedication\u003e}` | |\n| `\\acknowledgments{\u003cacknowledgements\u003e}` | |\n| `\\disclaimer{\u003cdisclaimer\u003e}` | |\n| `\\abstract{\u003cabstract\u003e}` | |\n| `\\preface{\u003cpreface\u003e}` | |\n\n***Note***\n\n1. This ***appends*** the provided degree to a list, meaning this command can appear multiple times,\n   and each time it only needs one degree provided. When rendering the title page, these previous\n   degrees will be present in a first-in-first-out manner.\n2. Similar to `\\prevdegree`, this command can be called multiple times.\n\n\nTo control whether to show each page in the front matter, use `\\show\u003cpage name\u003etrue` to show a page\nor `\\show\u003cpage name\u003efalse` to make the page invisible. The following table shows available page\nnames in the front matter:\n\n| page name | default | note |\n| --------- | ------- | ---- |\n| title | on | |\n| certification | on | |\n| copyright | on | |\n| dedication | off | auto-turned on if `\\dedication` is called |\n| acknowledgments | off | auto-turned on if `\\acknowledgements` is called |\n| disclaimer | off | auto-turned on if `\\disclaimer` is called |\n| abstract | on | |\n| toc | on | table of contents |\n| lof | on | list of figures; required if figures are present |\n| lot | on | list of tables; required if tables are present |\n| los | on | use command `\\nomenclature` from package `nomencl` to define \u003cbr\u003e symbols |\n| glossary | on | through package `glossaries-extra` |\n| preface | off | auto-turned on if `\\preface` is called |\n\n***Note***\n\n1. The list of symbols (through package `nomencl`) and the glossary page (through package\n   `glossaries-extra`) require special settings for compilation. Please see the `latexmkrc` in the\n   example directory for how to configure them.\n2. Don't include `\\makenomenclature`, `\\printnomenclature`, `\\makeglossaries`, `\\printglossaries`,\n   or/and `\\printglossary` in your manuscript. They are already handled in the style definition.\n   Just use the commands to define glossary terms and symbols directly.\n\n\n### Math font\n--------------\n\nMath font is handled by package `unicode-math`. Therefore, it is better to use `\\symbf`, `\\symit`,\netc., rather than native commands (e.g., `\\mathbf`, etc.). Also, `unicode-math` requires math\ntypesetting packages to be loaded before loading it, so `amsmath` and `mathtools` are loaded\nalready in the style definition file.\n\n\n### Bibliography\n----------------\n\nThe class only intervenes the format of bibliography/references when an user uses `biblatex` and\ntriggers the bibliography with `printbibliography[heading=bibintoc, ...]`. Otherwise, users have to\ndeal with the reference format manually. As per GW and SEAS guidelines, users are free to choose\nwhatever citation and bibliography styles. This class only ensures 1) single-line spacing within\neach entry, 2) double-line spacing between entries, and 3) the spaces after heading.\n\n## Example\n----------\n\nThere's an example TeX file and corresponding `latexmk` configuration file in the folder `example`.\nWhen using command-line in Linux, simply go to the example folder and execute:\n\n```shell\n$ latexmk\n```\n\nMany GUI interfaces also have places for users to configure and use `latexmk`.\n\n\n## Format guidelines\n--------------------\n\nThe major guideline is the example PDF from the School of Engineering and Applied Science (SEAS) for\nSpring 2021:\n\n  * [Sample PDF](https://library.gwu.edu/sites/default/files/2021-06/SEAS%20Dissertation%20Sample%20format_Spring%202021.pdf)\n\nIf the SEAS guideline is not clear enough, then the GW university-level guideline (as of Feb. 15,\n2022) is used as a supplement. Guideline from GW Library as of Feb. 15, 2022:\n\n  * [Webpage](https://library.gwu.edu/gw-etd-formatting)\n  * [PDF](https://library.gwu.edu/sites/default/files/2021-10/Downloadable%20University%20Formatting%20Guidelines%20Oct%205%202021.pdf)\n\nThere's another version of SEAS sample PDF file on the internet. There are some differences between\nthe Spring 2021 version and this version. So this one is not used as a guideline. Just for your\ninformation:\n\n  * [Another SEAS sample PDF](https://graduate.seas.gwu.edu/sites/g/files/zaxdzs1526/f/downloads/SEAS%20PhD%20ETD%20Style%20Guide.pdf)\n\n\n## Issues\n---------\n\nThis section lists some format issues and discrepancies between the GW library guideline and the\nSEAS sample PDF.\n\n##### Title page:\n\n1. Author name: GW uses normal font; SEAS' sample uses bold face.\n2. Text: GW says: _\"... in partial_satisfaction ...\"; SEAS says: _\"... in partial\n   fulfillment ...\"_\n\n##### Certification page:\n\nLetter case: GW says: _\"... approved form of the dissertation.\"_; SEAS says: _\"... approved form of\nthe Dissertation.\"_\n\n##### Dedication page:\n\nSEAS uses an indent of 0.5in for all paragraph; GW doesn't say that (though GW also requires 0.5in\nindent for all other front pages).\n\n##### Abstract page:\n\nDissertation title: GW wants a normal-font title, while SEAS sample uses bold-face font. Space after\ntitle: GW says 2 single-line spacing; SEAS sample says one single-line spacing.\n\n##### Table of Contents:\n\n1. GW uses single-spacing within an entry but uses double-spacing between entries. However, the\n   example PDF from SEAS doesn't seem to use the double-spacing between entries. In SEAS sample\n   PDF, the spacing between entries is something smaller than double-spacing but definitely\n   larger than single-spacing.\n2. Both GW and SEAS guidelines do not specified the indents of sections, subsections, etc.\\~ in\n   the table of contents.\n\n##### List of Figures:\n\nGW guidelines says: _\"Use two (2) single spaces between entries.\"_ This is probably a typo.  Based\non the sample figure in the GW guideline, it probably means double-spacing.\n\n##### List of Symbols:\n\nSEAS adds indices to symbols in the list, which totally doesn't make sense. I removed them in this\nclass.\n\n##### Normal paragraphs in the body of document:\n\nGW guideline uses 0.5in indent for all paragraphs. GW sample PDF actually uses 0.5in indent for\nparagraphs in chapter 2 to 5 and appendices. However, in chapter 1, GW sample uses some number less\nthan 0.5in, which I believe it's a mistake.\n\n## License\n----------\n\nBSD-3 license.\n\n## Other known efforts\n----------------------\n\n* https://github.com/skulumani/thesis-gwu\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiyueh%2Fgw-dissertation-class","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiyueh%2Fgw-dissertation-class","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiyueh%2Fgw-dissertation-class/lists"}