Skip to content

Bootstrap a new LaTeX project in less than a minute.

License

Notifications You must be signed in to change notification settings

makenew/latex-project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Sep 30, 2022
3af934b · Sep 30, 2022

History

86 Commits
Sep 21, 2022
Sep 19, 2022
Nov 7, 2015
Sep 16, 2015
Sep 19, 2022
Sep 16, 2015
Sep 19, 2022
Sep 21, 2022
Sep 19, 2022
Sep 19, 2022
Sep 30, 2022
Sep 21, 2022
Sep 19, 2022
Sep 21, 2022
Sep 19, 2022
Sep 19, 2022

Repository files navigation

LaTeX Project Skeleton

GitHub Actions

Package skeleton for a LaTeX project.

Description

Bootstrap a new LaTeX project in in five minutes or less.

Features

Bootstrapping a new project

  1. Create an empty (non-initialized) repository on GitHub.
  2. Clone the master branch of this repository with
    $ git clone --single-branch [email protected]:makenew/latex-project.git <new-latex-project>
    $ cd <new-latex-project>
    
    Optionally, reset to the latest version with
    $ git reset --hard <version-tag>
    
  3. Run
    $ ./makenew.sh
    
    This will replace the boilerplate, delete itself, remove the git remote, remove upstream tags, and stage changes for commit.
  4. Create the required GitHub repository secrets.
  5. Review, commit, and push the changes to GitHub with
    $ git diff --cached
    $ git commit -m "Replace makenew boilerplate"
    $ git remote add origin [email protected]:<user>/<new-latex-project>.git
    $ git push -u origin master
    
  6. Ensure the GitHub action passes, then publish the initial version of the package with
    $ npm install
    $ npm ver patch
    

Updating from this skeleton

If you want to pull in future updates from this skeleton, you can fetch and merge in changes from this repository.

Add this as a new remote with

$ git remote add upstream [email protected]:makenew/latex-project.git

You can then fetch and merge changes with

$ git fetch --no-tags upstream
$ git merge upstream/master

Changelog for this skeleton

Note that CHANGELOG.md is just a template for this skeleton. The actual changes for this project are documented in the commit history and summarized under Releases.

Development

Quickstart

$ git clone https://github.com/makenew/latex-project.git
$ cd latex-project
$ npm install
$ make

Requirements

Development

Install any Node and Bower dependencies with

$ npm install

Build to build/ with

$ make

Clean out temporary and build files with

$ make clean

Lint code with

$ make check

Watch code and rebuild on changes with

$ npm start

Source Code

The makenew-latex-project source is hosted on GitHub. Clone the project with

$ git clone https://github.com/makenew/latex-project.git

Contributing

Please submit and comment on bug reports and feature requests.

To submit a patch:

  1. Fork it (https://github.com/makenew/latex-project/fork).
  2. Create your feature branch (git checkout -b my-new-feature).
  3. Make changes.
  4. Commit your changes (git commit -am 'Add some feature').
  5. Push to the branch (git push origin my-new-feature).
  6. Create a new Pull Request.

License

This LaTeX project is licensed under the MIT license.

Warranty

This software is provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright holder or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.