Skip to content

create or update profile

bmen edited this page Mar 31, 2023 · 1 revision

: Process Image (resize and crop)

For this step we're using the App Telegram messenger, because many have it installed and it's easy to use. You can use any other app or method to resize and crop the images if you want. A website we recommend if you don't want to use an app is https://www.resizepixel.com .

The following steps may vary a bit depending on the operating system on your phone and the apps you're using.

  • scroll to the profile image
  • long-tap on it and tap share image
  • select Telegram as sharing app
  • select saved messages (this may be translated to your local language in the app) in the contact list (We don't want to send the image to anybody. The saved messages behaves like a contact/group/channel, but isn't sent to anybody.). Then tap the "send" icon (small arrow)
  • check if cropping is needed:
    • The goal of this step is to make sure all images on LEAD are in a similar format. The visible image section should act as a good profile picture for the person. So, not too many unnecessary details that distract from the person.
    • Also the Aspect Ratio is important. Aspect Ratio means the width compared to the height.
      • Normally, the photos are a bit higher than wide.
      • They should not be more than 1,5 times high than wide (otherwise they would take much more space in the LEAD profile overview, which would be unfair)
      • On the other hand, the photo should also not be more wide than high - in other words, height should minimal be the width (a square). Otherwise the photo would take much less space in the LEAD profile overview, which would also be unfair.
    • If you decide some cropping/resizing is necessary, tap on . Then drag the corners until you're satisfied.
    • confirm with tapping on "cut" (or similar) and "send" (small arrow)
  • you now see the cropped image, telegram also made the resolution smaller, so that it will take less time to load
  • save image
    • tap on the picture in the chat view
    • tap on the icon with three dots over one another
    • tap "save to gallery"

: xxxxx

It is best to have two tabs open: one for this article, the other one to follow the instructions on github.com

  • log in to github.com
  • go to the LEAD repository: https://github.com/ASKnetCommunity/LEAD
  • go to Issues and find the issue containing the profile you want to create/update (search for the name or go to Labels > Profile)
  • scroll down and under the heading Development tap on Create a branch
    • by tapping on Change branch source make sure the Branch source is main
    • tap Create branch
    • close the dialogue Checkout in your local repository
  • scroll up and click on Code

: Create Profile File

  • after you went to Code, you need to switch to the branch you just created. Tap on the button labeled (probably main) and tap on the branch you just created, which should be named after the person that you want to create a profile for.
  • tap on View code (you may need to scroll down a bit), go into the folder _profiles/
  • click ... (up right), then Create new file
  • the name must be chosen like: surname-name.md, for example Emile-Exampleton.md
  • copy the template (see below) into the new file
    • scroll to the heading template of the profile code
    • tap somewhere on the code
    • an icon appears: - tap on it, the code is copied
    • switch back to the previous tab
  • In the editing area (Enter file contents here), tap long and tap on paste. The copied code should appear.

Step 6: Copy Profile Information

Copy the information separately from the issue into the new file. The images will be dealt with after that.

  • for example, replace NAME_HERE with the name of the new LEAD member.
  • the region needs to be in the official list of regions (which can be found here below the heading "Region")
  • when copying the name of the hub / organization, check on the LEAD website in the filter (or in the existing profiles) if the hub is already present in another profile. If that is the case, check that it is spelled in the same way. Otherwise the differently spelled hub would appear also in the hub filter list.
  • copy the skill data:
    • The text below "Skill 1" in the issue shall replace SKILL1 in the profile file
    • The text below "Qualifications for Skill 1" in the issue shall replace QUALIFICATION1 in the profile file
    • Skills must be in the list (which can be found here below the heading "Skills"). If it is not, copy the text that was provided to the description text and use a skill from the list instead. (Example: member stated "painting" as skill 1. So: copy "painting" to the qualification for skill 1 and write "Media & Art" instead)
    • if markdown needs to be used: (for new lines, images, links etc.)
      • use \n to create a new line, to have a new paragraph shown you need two lines → \n \n

      • use * to create lists (don't forget the space after *)

      • use ![alternative text](/assets/images/profiles/NAME_HERE/NAME_HERE.jpg) for images

      • use [link-text](https://www.example.com) for links

      • example:

    skills:
      - {name: Hardware & Repair, number: 1, qualification: "
        Here you find a list of accomplishments: \n 
        \n 
        * Diploma in XY [link-text](https://www.example.com) \n
        * Certificate in XYZ \n
        "}
  • if less than four skills are in the profile: delete the lines in the profile file that are not used. For example: If three skills are in the profile, delete the line - {name: SKILL4, number: 4, qualification: "QUALIFICATION4"} .
  • if the contact options "facebook", "instagram" etc. have the full name instead of the username, look the person up on facebook/instagram and copy the username instead. Otherwise the links on the profile won't work.
  • when copying the description text, check if it is written in proper markdown (for example, between two paragraphs there always needs to be an empty line, otherwise it is shown as one paragraph without any wordwrap).

: Image

We upload the image to GitHub now and come back to creating the file later.

  • scroll up and long-tap on Code > open in a new tab
  • switch to new tab
  • View Code > assets > images > profiles - this is the folder where all profile images are saved
  • We need to create a folder for the new person. To do this we need to do an extra step.
    • scroll up and tap ... > Create file
    • type NAME-HERE/.gitignore, but replace NAME-HERE with the name of the new person. Replace any blank spaces with a - (meaning a minus). This will create a folder. (Note: after typing / the folder name will automatically added to the line above. Don't be irritated, it's a feature, not a bug.)
    • scroll down and tap create new file
  • in the folder list you should see the new folder with the name of the new person you just created. Tap on it.
  • scroll up and tap ... > Upload files > choose your files
    • this step depends on which phone / operating system you have. You need to find the cropped/resized photo that you downloaded earlier and choose it.
    • scroll down and tap commit changes

merge issue-branch into main [###] for more context about this step please read article XXXXXX


Step 7: Save and Upload

  • save
  • commit to content branch.