<\/figure>\n\n\n\nIf you are using a Windows machine, then the page might look slightly different and you should follow the instructions for installing on Windows. The rest of this document will assume that you are using a Mac. <\/p>\n\n\n\n
Install the package file that you downloaded from the pandoc site by double-clicking on the downloaded file. It should then walk you a self-explanatory set of steps to complete the installation.<\/p>\n\n\n\n
Ready? Is it installed?<\/strong> Unlike many apps, Pandoc has no graphical user interface. You will have to open up the Terminal app on a Mac and use the command-line. It’s easier than it sounds. On a Mac, the terminal app is in the Applications => Utilities folder. <\/p>\n\n\n\n <\/figure><\/div>\n\n\n\nOpening the terminal app will pop up the Terminal window. Your terminal app will look different than mine. Since I use the terminal app a lot, I’ve customized the colors and have a translucent background. But what you should be the same is in the upper left corner will be a prompt that ends in a $ sign<\/strong>. The prefix of the prompt will differ; it often displays the machine name and the username that is logged in. <\/p>\n\n\n\n <\/figure><\/div>\n\n\n\nPlace the cursor focus in the window with the mouse (or trackpad on a laptop) and click. This should bring the terminal app to the foreground so that you can type commands into the terminal app. <\/p>\n\n\n\n
To see if you have installed pandoc successfully, you can type the command: <\/p>\n\n\n\n
which pandoc<\/code><\/p>\n\n\n\nHit return (or enter) after typing the command. The terminal should then display a line that provides the path to the application. The path displayed on your Mac might be slightly different than mine below. Don’t worry. The important thing is that a path appears. If you enter the command “which pandoc”, hit return, and nothings happens, then pandoc is not installed. If you have a problem installing pandoc, then that requires a consultation with someone more experienced. <\/p>\n\n\n\n
<\/figure><\/div>\n\n\n\nOkay, let’s assume that pandoc installed correctly.<\/p>\n\n\n\n
Locate your .docx file<\/strong>. For simplicity, let’s just say that the docx file you want to convert is in the Downloads folder. In that case, from the command prompt, you should be able to type cd Downloads<\/code>, and hit enter. To ensure you are in the right directory, you can the command pwd<\/code>, which means “print working directory”; this command will display the current directory you are in. <\/p>\n\n\n\n <\/figure><\/div>\n\n\n\n Important<\/strong>: the Word file MUST<\/strong> be a .docx<\/strong> file. (Note the x at the end of the file extension.) If it is a .doc file (no x<\/strong>), then you must open the file in Word and save it as .docx before proceeding.<\/p>\n\n\n\nThe actual conversion<\/strong>: for this step, you must know the exact filename that you want to convert. If you have any spaces in the filename, then you must enclose the filename in quotation marks in the following command. Otherwise, an error will result. Note<\/strong>: on the command line, filenames are case sensitive. <\/p>\n\n\n\nTo convert the file named “Weiden The Peak final.docx” to html, use the following command:<\/p>\n\n\n\n
pandoc \"Weiden The Peak final.docx\" -t html -o weiden.html<\/code><\/p>\n\n\n\nIf all is successful, after hitting enter, then nothing should appear to have happened. Huh? Yes, success is not getting an error message. If you just get the blank prompt, then the file probably converted successfully. To ensure that the file converted, you can list the filename on the screen by using the list command and the name of the html file: ls weiden.html<\/code><\/p>\n\n\n\nAt this point, you can open the html file in a text editor. Do not use Notepad. You may want to download and use Atom<\/a> (free), which is what I use though there are many other options. Here’s what our sample file looks like after the pandoc conversion from .docx to .html and opened in Atom (only part of the file is shown in the image below):<\/p>\n\n\n\n <\/figure><\/div>\n\n\n\nStep 4: Copying to WordPress<\/h2>\n\n\n\n The hard part is now over. <\/p>\n\n\n\n
Next, you simply copy and paste the HTML, as shown above, from Atom (or another text editor) and paste into the editing space for the post you created in WordPress:<\/p>\n\n\n\n
<\/figure><\/div>\n\n\n\nSave the draft.<\/p>\n\n\n\n
Step 5: Adjusting the author name<\/h3>\n\n\n\n By default, the author of the post in WordPress will be you. If the actual author has not yet published a piece in The Peak, then you will need to add the author information to The Peak user database. You can check to see if the author is already listed by opening up the dropdown menu in the Author section of the WP post, which is located towards the bottom of the screen:<\/p>\n\n\n\n <\/figure>\n\n\n\nIf the author is already listed, then you can just select the author name and save post. <\/p>\n","protected":false},"excerpt":{"rendered":"
Objective: a tutorial for the staff of Shenandoah in processing and uploading new posts to The Peak. The Peak is the blog-like supplement to the twice-yearly Shenandoah literary magazine. Credit for the technical development of The Peak goes to the wonderful work of W&L undergrad Coletta Fuller, who adapted Shenandoah’s primary theme and provided the […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[39],"tags":[],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/posts\/2177"}],"collection":[{"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/comments?post=2177"}],"version-history":[{"count":30,"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/posts\/2177\/revisions"}],"predecessor-version":[{"id":2219,"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/posts\/2177\/revisions\/2219"}],"wp:attachment":[{"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/media?parent=2177"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/categories?post=2177"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/endlesshybrids.com\/wp-json\/wp\/v2\/tags?post=2177"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}