Giter Site home page Giter Site logo

Comments (2)

morganist avatar morganist commented on July 3, 2024

hi! please refer to contributing guide, there's a section for making symlinks:
https://github.com/PapirusDevelopmentTeam/papirus-icon-theme/tree/master/tools/work#step-by-step-guide

however, if you are very-very new to this, then let me explain a bit, because the contributing guide assumes you know your way around git.
i assume you are using linux, right?

  1. you need to install git through your package manager. it's a CLI utility, a version control system that papirus uses. github is one of the web interfaces for git, and a place where the Papirus icon theme repository is hosted.
  2. you need to configure your git installation, in particular your display name and email address: https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup#_your_identity
  3. you need to fork a this repository on github, so that you have a personal copy where you can make various changes before you submit them, as well as clone (basically download) your fork to your computer. read this, especially the sections about forking and cloning: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo
  4. create a local branch for your every specific change. you don't want to make future commits to the master branch because it prevents maintainers (us) from helping you finish things up. i like to use git checkout -b [branch name] to create a branch and immidiately switch to it (that's what checkout does). it's a common practice to name branches according to symlink/icon you are making in it.
  5. now that you've cloned your fork to your computer and switched to your new branch, refer to the contributing guide.
  6. when you've successfully followed all the steps, you need to add files which you've modified/created to git so that it sees them. i like to run git add -v --all to automatically add all new/modified files and show which ones have been added. if we are talking about a symlink to an application, there would be 6 new files. at this point, git knows about these new files.
  7. if you are done, make and push a commit, so that your added changes (and your new branch) are sent to your forked repository on github: git commit -m "Add symlink/icon for something" to make and name a commit, then git push origin [branch name] to send changes to a server. you'll be prompted with a login and then a password. github doesn't allow you to use your github password for this, you need to create an authentification token in settings > developer settings > personal access tokens. use this token as a password for git CLI.
  8. push your commits, then go to the repository of your fork. there should be a banner up top saying that your new branch has changes, so press the button that says compare and pull request.
  9. you'll be taken to the screen for creating a pull request (to this reporitory, the "upstream"). write something useful, maybe attach screenshots if you like.

i hope that's it! you shouldn't need anything but the basics of git in order to contribute to Papirus. Feel free to ask questuons if something is unclear.

from papirus-icon-theme.

heendra avatar heendra commented on July 3, 2024

Thank you for responding.
I will learn it.

from papirus-icon-theme.

Related Issues (20)

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.