Welcome to my site!

{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Your site","type":"text"}]},{"type":"paragraph","content":[{"text":"Your site URL will be: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://people.engr.tamu.edu/ ","type":"text"}]},{"type":"paragraph","content":[{"text":"Where is replaced with your actual NetID (without the <>).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Editing your site","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note: ","type":"text","marks":[{"type":"strong"}]},{"text":"If you are working remotely and/or not local to the College Station TAMU campus you will need to be connected to the TAMU College Station ","type":"text"},{"text":"VPN","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://tamuengr.atlassian.net/l/cp/MEUCyh8f"}}]},{"text":" to connect to the SFTP Server to edit your site.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"You will edit your site by using an SFTP client to connect to the people authoring site ","type":"text"},{"text":"people-edit.engr.tamu.edu","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Clients","type":"text"}]},{"type":"paragraph","content":[{"text":"SFTP clients enable you to upload files from your local machine to the web site via SFTP, as well as download files to your local machine from the web site. Listed next are some common clients based on common operating systems.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Windows","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"WinSCP","type":"text"}]},{"type":"paragraph","content":[{"text":"A free, commonly used SFTP client available from ","type":"text"},{"text":"winscp.net","type":"text","marks":[{"type":"link","attrs":{"href":"https://winscp.net/eng/download.php"}}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note when using WinSCP","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Because Amazon S3 manages object timestamps, be sure to disable WinSCP timestamp settings before you perform file transfers. To do so, in the WinSCP Transfer settings dialog box, disable the Set permissions upload option and the Preserve timestamp common option.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Mac","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Cyberduck","type":"text"}]},{"type":"paragraph","content":[{"text":"A fully featured free SFTP client that supports much more than just SFTP. It is available from ","type":"text"},{"text":"cyberduck.io","type":"text","marks":[{"type":"link","attrs":{"href":"https://cyberduck.io/download/"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Sftp","type":"text"}]},{"type":"paragraph","content":[{"text":"Mac users that are familiar with the command line can simply run the ","type":"text"},{"text":"sftp","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Linux","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Filezilla (Standard)","type":"text"}]},{"type":"paragraph","content":[{"text":"A common free SFTP client available in your Linux distribution’s package repository. The name of the package and method of installation varies per distribution (Google for it based on your distribution, i.e. Ubuntu, Centos, Arch, etc.).","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Sftp","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux users that are familiar with the command line can simply run the ","type":"text"},{"text":"sftp","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Where to connect","type":"text"}]},{"type":"paragraph","content":[{"text":"When connecting via your favorite SFTP client, you will use the following host:","type":"text"}]},{"type":"codeBlock","content":[{"text":"people-edit.engr.tamu.edu","type":"text"}]},{"type":"paragraph","content":[{"text":"to perform all of your uploads. You will enter your ","type":"text"},{"text":"NetID","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"NetID password","type":"text","marks":[{"type":"code"}]},{"text":" for username and password respectively.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Authoring your site","type":"text"}]},{"type":"paragraph","content":[{"text":"Following these guidelines when adding content to your site:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you want to hand out a URL with a directory instead of a file (e.g. ","type":"text"},{"text":"https://people.tamu.edu/netid","type":"text","marks":[{"type":"code"}]},{"text":"), you will need to add an index.html file to the directory so that a page will load.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All files must have an extension (i.e. end with .html, .txt, .jpg, etc.).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Directories cannot have a dot (“.”) in the name or they will not work properly.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To start building your page, create an index.html file on your local machine and upload it to your directory. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"You should view and develop your index.html and other pages locally, then upload them to the SFTP server when you are finished making changes.","type":"text"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"When you create a link inside of a web page, the link should look something like this:","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"My page","type":"text"}]}]},{"type":"paragraph","content":[{"text":"and NOT like this:","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"My page","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Making relative links like the first one allows your page to work properly on your local computer as well as the remote server. This makes development easy because you can see changes in your local web browser and only upload once when you are finished making changes.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Connection setup using FileZilla","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"FileZilla Example (your client will vary)","type":"text"}]},{"type":"paragraph","content":[{"text":"Open the FileZilla application","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Add a new site","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"File ","type":"text","marks":[{"type":"strong"}]},{"text":"> ","type":"text"},{"text":"Site Manager","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the following pop up window, click on the ","type":"text"},{"text":"New Site","type":"text","marks":[{"type":"strong"}]},{"text":" button on the left side","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type ","type":"text"},{"text":"people-edit","type":"text","marks":[{"type":"code"}]},{"text":" into the field that pops up","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"SFTP - SSH File Transfer Protocol ","type":"text","marks":[{"type":"strong"}]},{"text":"from the ","type":"text"},{"text":"Protocol ","type":"text","marks":[{"type":"strong"}]},{"text":"dropdown on the right side","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type in ","type":"text"},{"text":"people-edit.engr.tamu.edu","type":"text","marks":[{"type":"code"}]},{"text":" into the ","type":"text"},{"text":"Host ","type":"text","marks":[{"type":"strong"}]},{"text":"field","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type your NetID into the ","type":"text"},{"text":"User ","type":"text","marks":[{"type":"strong"}]},{"text":"field","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type your NetID password into the ","type":"text"},{"text":"Password ","type":"text","marks":[{"type":"strong"}]},{"text":"field (this will be removed if you opt not to have your password remembered in step 9).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose either ","type":"text"},{"text":"Save Password","type":"text","marks":[{"type":"strong"}]},{"text":" to have your password remembered, or ","type":"text"},{"text":"Do Not Save Password","type":"text","marks":[{"type":"strong"}]},{"text":" to enter it each time. It is more secure to pick the latter option.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":85.0},"content":[{"type":"media","attrs":{"width":1416,"alt":"Site Manager - General settings","id":"cd934e53-242a-41bb-b1f2-dece7a2b5ae2","collection":"contentId-1357086758","type":"file","height":1044}}]},{"type":"heading","attrs":{"level":4},"content":[{"type":"hardBreak"},{"text":"Connect to your site","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"File ","type":"text","marks":[{"type":"strong"}]},{"text":"> ","type":"text"},{"text":"Site Manager","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the following pop up window, click on ","type":"text"},{"text":"people-edit ","type":"text","marks":[{"type":"strong"}]},{"text":"on the left side","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Connect ","type":"text","marks":[{"type":"strong"}]},{"text":"button","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When prompted with the security warning, check the ","type":"text"},{"text":"Always trust this host, add this key to the cache","type":"text","marks":[{"type":"em"}]},{"text":" box and click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Add a Welcome Page to your site","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a directory just for housing your website files called ","type":"text"},{"text":"Engineering People Site","type":"text","marks":[{"type":"code"}]},{"text":" and make a note of where the directory lives","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a file named ","type":"text"},{"text":"index.html","type":"text","marks":[{"type":"code"}]},{"text":" in your newly created ","type":"text"},{"text":"Engineering People Site","type":"text","marks":[{"type":"code"}]},{"text":" directory using your favorite text editor and place the following contents in the file: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n

\n\nWelcome to my site!\n\n

\n\n\n\n\n

Welcome to my site!

\n\n\n\n\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View your new ","type":"text"},{"text":"index.html","type":"text","marks":[{"type":"code"}]},{"text":" page locally in your browser by going to your favorite web browser, going to ","type":"text"},{"text":"File ","type":"text","marks":[{"type":"strong"}]},{"text":"> ","type":"text"},{"text":"Open","type":"text","marks":[{"type":"strong"}]},{"text":", and browsing to your new page. Once you are satisfied with the page, proceed to the next step.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect to the people-edit site by using the directions under ","type":"text"},{"text":"Connect to Your Site","type":"text","marks":[{"type":"link","attrs":{"href":"https://tamuengr.atlassian.net/wiki/spaces/helpdesk/pages/edit-v2/1357086758?draftShareId=ddd3b25d-3b2a-4b0c-bd4e-9ef1a7f0fc0f#%5BhardBreak%5DConnect-to-your-site"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the upper left window of FileZilla, navigate to the ","type":"text"},{"text":"Engineering People Site","type":"text","marks":[{"type":"code"}]},{"text":" directory that you created earlier. You will see the ","type":"text"},{"text":"index.html","type":"text","marks":[{"type":"code"}]},{"text":" file in the lower left window.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":86.0},"content":[{"type":"media","attrs":{"width":1600,"alt":"FileZilla people-edit directory","id":"189a1457-2200-4616-bb68-c2c2f3ad3eda","collection":"contentId-1357086758","type":"file","height":1312}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click on the ","type":"text"},{"text":"index.html","type":"text","marks":[{"type":"code"}]},{"text":" file in the lower left window and select ","type":"text"},{"text":"Upload","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the file is new, then it will be uploaded and you will be finished. However, if you make edits to the file and upload it again, the file will already exist on the server and you will receive a prompt about how to handle overriding the file. The easiest option is to always override the file on the server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":1524,"alt":"Overwrite Target file already exists","id":"aa285f70-ff22-4538-81f2-fb626cd0e9dc","collection":"contentId-1357086758","type":"file","height":720}}]},{"type":"paragraph","content":[{"text":"You can now view your site in the browser by going to ","type":"text"},{"text":"people.engr.tamu.edu/","type":"text","marks":[{"type":"code"}]},{"text":" (replacing with your actual NetID) ","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Due to server-side caching, it may take up to two minutes for your changes to appear; this is why it is important to develop your page on your local machine before uploading it.","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Adding Directory Listings to your site","type":"text"}]},{"type":"paragraph","content":[{"text":"Sometimes you want a directory to have its contents listed so that users can freely download files without creating a traditional index.html where you manually link to everything. In Apache, these are called ","type":"text"},{"text":"directory listings","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"This is not possible with the current solution by default, so you must add a special ","type":"text"},{"text":"index.html","type":"text","marks":[{"type":"em"}]},{"text":" file to the directory that you want to have contents listed. In order to use the directory listing feature, ","type":"text"},{"text":"download index.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://drive.google.com/uc?export=download&id=1-Bv2csW4_KAC3cZWQ6IzlSPI15sg1_S-"}}]},{"text":", and place it on your site in whatever directory you want to see the listings. Now you can give out the link to that directory and the listings will show up in a similar way to the traditional Apache web server listings.","type":"text"}]}],"version":1}

Browser not supported