Can someone make a video in which you create a map in github?

Cernel

I don't need any explanations or anything special; just do the stuff for a simple map like minimap, whatever ways you prefer, and take a video while you do it, from the start till the end; I'm sure I will understand. No need of anything else.
It doesn't neet to be a refined video, or anything particularly well made. Please, keep the cursor visible.

Cernel

Or if noone is going to make a video I guess you can explain me how can I create the map subfolder and paste all the stuff inside it at once, in non zip format, as that is where I'm stuck; tho I fear I will just then get stuck a step after again. I still prefer the video; it is much easier to learn stuff by watching it.

redrum

@Cernel So were you able to create a new repo? If so then there is a green "Clone or download" button to use to clone it down to your PC. Then you should have an empty folder where you copy your map files into.

If so can you post the link to the repo?

Cernel

@redrum Yes I got there to clone on my computer, then I added the map folder with the stuff inside but I can't see how that stuff can go back at once in the repository; I also tried GitHub Desktop. You can find it in my profile in github:
https://github.com/Cernelius/270bc_variants

I see there are different ways to do it. Is GitHub Desktop the normal way people use?

Don't look at the fact that there is some structure folders. I have not figured out. I've just hacked that by creating a dummy file and then uploading the files and then removing the dummy, as you can see in the history; but of course I see noone does it this way. Just can't get what is the normal way.

I was not much worried, since various people figured, I guessed I would have figured it too, eventually. But I guess there is something I'm just not seeing somewhere and got tired to wait till I see it.

I've actually not again worked to try to figure it out as I'm writing the reply to the AI bonuses, cept now I got to cont a save in lobby.

Also, it seems a bit slow on my end, so it would be crazy doing it that way with another map as that is so heavy I guess I will have to let it upload for some hours no stop. This one is just a very simple variant I'm trying to get there. Most likely it is something simple just like I'm not seeing something obvious.

Cernel

Side note, since the history is silly, I want to delete that repository and redo another with the same name, from scratch. Would that be fine right?

Cernel

Sorry if it sounded like it was urgent. I was just being angry, but it is not urgent, but yeah (it is a while now LOL). Mostly I find difficult to get back trying to figure it out at all because I just get angry at not understanding immediately.

redrum

@Cernel Oh, yeah you got the repo created and files uploaded. Yeah most folks use GitHub Desktop to push and pull updates with the github repo. Don't worry about the history. You can redo it but no real reason to.

I would recommend making sure your repo ends up looking similar to @Frostion as he seems to have the process down pretty well: https://github.com/triplea-maps/iron_war

Cernel

I'm still blocked as being unable to do the first step, meaning I don't know how to do this:
https://github.com/triplea-maps/iron_war/commit/b4742e538d53a5fe633809cc47dedb001bce0648

Definitely it is not possible with the basic things, because you cannot paste not zipped folders, but only the files in it, and only up to 100 at time. So, I guess you need to do it with GitHub Desktop.
I've not actually tried again Desktop since I opened this topic.

Cernel

I mean, yes, I could do it all the way I did it, by creating a folder with a dummy file and uploading up to 100 files at times, but I need to figure out how to do it the correct way, because it would be ridiculous to do it that way with some other maps then this simple one.

redrum

@Cernel Oh you used the github web interface instead of GitHub Desktop. I didn't realize that. Yeah, you want to use GitHub Desktop so you don't have the 100 file limit.

Essentially, it should go something like:

Open GitHub Desktop
Clone the repo (only do this the first time)
Click "Sync" button in upper right hand corner to make sure you have all the latest files on your PC
Add/update/remove files with whatever editor/file system
You should be able to see the changes in GitHub Desktop in the "Changes" tab (click it at the top)
There you can select which changes you want to upload and add a message describing them
Then click "Commit"
Then click "Sync"
Now navigate to your github repo in the web browser and you should see the uploaded files

Frostion

I don’t know if you have overcome your hurdle @Cernel? I would like to help, but I used Git GUI not GitHub Desktop.

When I uploaded Iron War I felt it was like a first time again, even though I had uploaded maps before. I keep forgetting how to do it, and I think it is a little difficult, so I made a little guide while doing it. I was thinking that it could maybe be made into a general guide for all first time map uploaders, or just something I could use myself in the future.

It would be nice if you guys could take a look at the guide and see if it is suitable as a new upload guide we could post here at the forum. Please feel free to edit, fix procedure errors, fix strange language, clarify and improve anything you like. I copied the guide into this google doc, so hopefully you can all see and edit it and maybe expand it:

https://docs.google.com/document/d/1FfF7N0srp9QG0_if5D-c1d1Aa1QTttdhxgm1GBh3pI4/edit?usp=sharing
(also, tell me if the link does not work)

Cernel

@Frostion Oh, that looks great. I will do it that way then (but tx to @redrum too), so I will test your guide, as well, from the perspective of someone that doesn't know what to do.
But, out of curiosity, since it seems there are different things to do the GitHub stuff, why not a suggested one of them all?
For example, you use Git GUI instead of GitHub Desktop because you think it is better?

Frostion

@Cernel I used it as it was the tool I knew. But I'm no experienced user.
Maybe a guide here on the forum should have several tools included, or just the one that is easiest to use.

RoiEX

@Cernel

For example, you use Git GUI instead of GitHub Desktop because you think it is better?

This totally depends on you.
Some people like git as a command-line-tool others (like me) like advanced GUI-tools like git kraken, which makes it really easy to achieve what you want if you know what to do without having to know all the commands.
I used GitHub Desktop for quite a while because it's easy to start with but some time later I realized the limited functionality so I switched.

Cernel

@Frostion
Ok. I was able to do the stuff (I've still to ask to be added up) following your guide; so, congrats, this proves that your guide works fine with no need of knowing / remembering anything.
I'm thinking to eventually update the Wiki as per your guide. A mapmaker should be able to do all reading only that, with no need of knowing anything else.
But, beside the Wiki in Projects, what did you read to learn what to do? Did you just figure it all out by yourself? Mostly curious.

EDIT: I think the only step missing is explaining where are you going to actually see the request to join (I still don't know if I have to look in my mail?). I guess it is already explained in the Wiki and I'm not seeing it right now.

EDIT: Only one thing. Looks like blindly following your steps I deleted the README from my repository? Is that intended or I did something wrong? Also, I seem to understand that now they don't want anymore the transfer ownership but a request to the admins to fork (which I'm not sure what it means, I'm guessing it's like copy-paste of the repository).

Frostion

@Cernel
README file: As far as I remember this file is made when you create a repository at your own space at Github. A box must be checked before pressing a button. I don’t think the file is used for anything, but it spells out the name of your map in big text, so I kind of like it. I don’t know how to make a new file if you did not make it when creating the repository.

I can see that you have talked with DanVanAtta about how to do a first time upload. In regards to the map preview picture, I think I will move the one I have in Iron War in an “Extra” folder to a “description” folder beside “map” like in all my other maps. It is strange that there is not a standardized place to upload a preview picture, but to me it makes sense to have it near or in the map files.

“they don't want anymore the transfer ownership but a request to the admins to fork” … I also don’t know what this means. My knowledge of GitHub corresponds to what is described in the guide. It would be great if we could get this in “simple and stupid” language so that the guide could be updated. I think it would be great if you can post the guide in the wiki. Optionally you could also add a description of how to use other tools – if you did not use Git GUI.

prastle

@Cernel map update last night worked and your maps of 270 etc in bots nice stuff. Glad they finally there.

Cernel

@prastle Thanks. I'd love to see other people hosting it. Spotted a couple. Feel free to host it yourself too, if you like, of course.

Cernel

@Frostion Why do you say to select "Force overwrite existing branch (may discard changes)"? Would you do that also for updating or only for the first push? What do the developers think / suggest?

Frostion

@Cernel
I must say that I dont know 100% what this feature is and what it is for, but if I don't use that overwrite thing, then the files do not seem to upload and replace the old uploaded stuff. Instead an error just occurs and no upload happens.

When I have to update an entire map with like hundreds of new versions of tiles or many new unit pictures, I go to the local repository directory on my PC, then delete all the content but not the main dir itself, then I copy over ALL the files of my working map directory. (I usually also do a Windows "clean up" of system files and miniature windows dir-icons, but I don't know if this is actually needed to not upload windows junk files like that to GitHub). I finally go and open GitGUI, chose option to open a previous worked on local repository and when the program is all started up, then I do the push process. Then I see that GitGUI recognizes what files have actually been changed since last and it uploads these files.