{"_id":"581fa361ced6a41900977fb6","category":{"_id":"581fa361ced6a41900977fa9","__v":0,"version":"581fa361ced6a41900977fa6","project":"56ea19ac77878a0e009e17ef","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-03-17T02:42:52.341Z","from_sync":false,"order":2,"slug":"documentation","title":"Getting started with the platform"},"parentDoc":null,"user":"56ea19901a800f0e00d9270a","githubsync":"","version":{"_id":"581fa361ced6a41900977fa6","project":"56ea19ac77878a0e009e17ef","__v":1,"createdAt":"2016-11-06T21:40:49.602Z","releaseDate":"2016-11-06T21:40:49.602Z","categories":["581fa361ced6a41900977fa7","581fa361ced6a41900977fa8","581fa361ced6a41900977fa9","581fa361ced6a41900977faa","581fa361ced6a41900977fab"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Stallion 5","version_clean":"5.27.0","version":"5.27"},"__v":0,"project":"56ea19ac77878a0e009e17ef","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-04-28T23:33:55.968Z","link_external":false,"link_url":"https://betterjournalism.org/i/platform/adding-new-stories/","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","examples":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Adding a story to your chapter’s website is simple — the process generally takes around three minutes per story, not including the addition of photos. While we call them “stories” and “articles,” the control panel refers to them as “posts.”\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/70d9885-Screen_Shot_2016-08-10_at_11.40.51_AM.png\",\n        \"Screen Shot 2016-08-10 at 11.40.51 AM.png\",\n        2880,\n        1462,\n        \"#f6f6f6\"\n      ]\n    }\n  ]\n}\n[/block]\n## Required portions of a story\n\nTo add a new story, click **“Add New**” while you’re on the** Posts **page (left hand bar). Each story must include the following:\n\n  * A **title**. (Left column, top) It should be news-oriented and descriptive, giving us an idea of what’s going on. An example would be “Sandwich Football Players Triumph at State Competition 10-5”. Ensure that the *length is between 6-12 words and the capitalization is title-case*, with all important words capitalized.\n  * The **article** itself. (Left column, big text area). Are you copy-pasting the article from somewhere else, like your email or Word? See the below addendum. If you're adding elements such as pull quotes to an article that already has a featured photo, be sure not to do so in the indicated 'danger zone' of the article.\n  * A **short-length article title**. (Left column, below) The short-length title should be three words (or four short words). The website uses this when space is tight. An example would be “Football at state level”. Ensure that it never exceeds *three or four words* and the capitalization is sentence-case, with only the first word (and proper nouns, of course) capitalized.\n  * The article **author**. (Left column, below) The author should always be in the “First Last” format (eg. “George Washington”). If there’s more than one author, the names should be separated with commas. Don’t include “and”.\n  * **Relevant categories.** (Right column, top) You must check at least one category. Generally, this is the type of article (sports, club news, etc.) but you might also check one for special sections (online exclusive, featured, etc.) If you would like the story to appear in one of the six main boxes on the front page and not the news ticker, you must check 'Featured' or the corresponding category set in PBJ Options.\n\nYou have to include all five of the above to publish an article. You can also include photographs, the names of web editors, and article highlights. Your chapter might also be utilizing the tagging feature to identify specific features, like the names of clubs — don’t use tags unless instructed.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7568c6b-Screen_Shot_2016-08-10_at_11.41.56_AM.png\",\n        \"Screen Shot 2016-08-10 at 11.41.56 AM.png\",\n        2560,\n        1408,\n        \"#f2f2f2\"\n      ],\n      \"caption\": \"Note the danger zone on the left hand side of the space for the body text.\"\n    }\n  ]\n}\n[/block]\n## When you’re done, you can either —\n\n  * **Publish** the article, if your chapter operates on a no-approval basis. Press the blue “Publish” button on the top-right to push the article live. If you’re just making changes, the button will say “Update”.\n  * **Submit the article for review**, if your chapter operates on a review-needed basis. Press the blue “Submit for Review” button on the top-right to indicate it needs review.\n  * If you don’t see a “Submit for Review” button, don’t press Publish. Instead, click “Edit” next to “Status” and select “Pending Review”. Then click **“Save as Pending” **above.\n \n## Here are some things to check:\n  * If there was a drop-cap, was the letter added back? If not, add it manually.\n  * There should not be an empty line in between paragraphs. If there is one, backspace them out. Is the piece broken into paragraphs at the wrong place?\n  * Did you copy-paste from a source that was broken into multiple portions on the paper (i.e. continuations)? If so, ensure that the entirety of the article is present. \n\n[Quotes, article highlights, and headings](doc:quotes-article-highlights-and-headings) \n[Uploading a featured image](doc:uploading-a-featured-image-1) \n[Uploading a featured image](doc:uploading-a-featured-image-1) \n\n[block:embed]\n{\n  \"html\": \"<iframe class=\\\"embedly-embed\\\" src=\\\"//cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2Fq_kgyJgHtiI%3Ffeature%3Doembed&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dq_kgyJgHtiI&image=https%3A%2F%2Fi.ytimg.com%2Fvi%2Fq_kgyJgHtiI%2Fhqdefault.jpg&key=02466f963b9b4bb8845a05b53d3235d7&type=text%2Fhtml&schema=youtube\\\" width=\\\"640\\\" height=\\\"480\\\" scrolling=\\\"no\\\" frameborder=\\\"0\\\" allowfullscreen></iframe>\",\n  \"url\": \"https://www.youtube.com/watch?v=q_kgyJgHtiI\",\n  \"title\": \"(PBJ) Screencast: Publishing a New Article\",\n  \"favicon\": \"https://s.ytimg.com/yts/img/favicon-vflz7uhzw.ico\",\n  \"image\": \"https://i.ytimg.com/vi/q_kgyJgHtiI/hqdefault.jpg\"\n}\n[/block]","excerpt":"","slug":"adding-new-articles","type":"basic","title":"Adding new articles"}

Adding new articles


Adding a story to your chapter’s website is simple — the process generally takes around three minutes per story, not including the addition of photos. While we call them “stories” and “articles,” the control panel refers to them as “posts.” [block:image] { "images": [ { "image": [ "https://files.readme.io/70d9885-Screen_Shot_2016-08-10_at_11.40.51_AM.png", "Screen Shot 2016-08-10 at 11.40.51 AM.png", 2880, 1462, "#f6f6f6" ] } ] } [/block] ## Required portions of a story To add a new story, click **“Add New**” while you’re on the** Posts **page (left hand bar). Each story must include the following: * A **title**. (Left column, top) It should be news-oriented and descriptive, giving us an idea of what’s going on. An example would be “Sandwich Football Players Triumph at State Competition 10-5”. Ensure that the *length is between 6-12 words and the capitalization is title-case*, with all important words capitalized. * The **article** itself. (Left column, big text area). Are you copy-pasting the article from somewhere else, like your email or Word? See the below addendum. If you're adding elements such as pull quotes to an article that already has a featured photo, be sure not to do so in the indicated 'danger zone' of the article. * A **short-length article title**. (Left column, below) The short-length title should be three words (or four short words). The website uses this when space is tight. An example would be “Football at state level”. Ensure that it never exceeds *three or four words* and the capitalization is sentence-case, with only the first word (and proper nouns, of course) capitalized. * The article **author**. (Left column, below) The author should always be in the “First Last” format (eg. “George Washington”). If there’s more than one author, the names should be separated with commas. Don’t include “and”. * **Relevant categories.** (Right column, top) You must check at least one category. Generally, this is the type of article (sports, club news, etc.) but you might also check one for special sections (online exclusive, featured, etc.) If you would like the story to appear in one of the six main boxes on the front page and not the news ticker, you must check 'Featured' or the corresponding category set in PBJ Options. You have to include all five of the above to publish an article. You can also include photographs, the names of web editors, and article highlights. Your chapter might also be utilizing the tagging feature to identify specific features, like the names of clubs — don’t use tags unless instructed. [block:image] { "images": [ { "image": [ "https://files.readme.io/7568c6b-Screen_Shot_2016-08-10_at_11.41.56_AM.png", "Screen Shot 2016-08-10 at 11.41.56 AM.png", 2560, 1408, "#f2f2f2" ], "caption": "Note the danger zone on the left hand side of the space for the body text." } ] } [/block] ## When you’re done, you can either — * **Publish** the article, if your chapter operates on a no-approval basis. Press the blue “Publish” button on the top-right to push the article live. If you’re just making changes, the button will say “Update”. * **Submit the article for review**, if your chapter operates on a review-needed basis. Press the blue “Submit for Review” button on the top-right to indicate it needs review. * If you don’t see a “Submit for Review” button, don’t press Publish. Instead, click “Edit” next to “Status” and select “Pending Review”. Then click **“Save as Pending” **above. ## Here are some things to check: * If there was a drop-cap, was the letter added back? If not, add it manually. * There should not be an empty line in between paragraphs. If there is one, backspace them out. Is the piece broken into paragraphs at the wrong place? * Did you copy-paste from a source that was broken into multiple portions on the paper (i.e. continuations)? If so, ensure that the entirety of the article is present. [Quotes, article highlights, and headings](doc:quotes-article-highlights-and-headings) [Uploading a featured image](doc:uploading-a-featured-image-1) [Uploading a featured image](doc:uploading-a-featured-image-1) [block:embed] { "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2Fq_kgyJgHtiI%3Ffeature%3Doembed&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dq_kgyJgHtiI&image=https%3A%2F%2Fi.ytimg.com%2Fvi%2Fq_kgyJgHtiI%2Fhqdefault.jpg&key=02466f963b9b4bb8845a05b53d3235d7&type=text%2Fhtml&schema=youtube\" width=\"640\" height=\"480\" scrolling=\"no\" frameborder=\"0\" allowfullscreen></iframe>", "url": "https://www.youtube.com/watch?v=q_kgyJgHtiI", "title": "(PBJ) Screencast: Publishing a New Article", "favicon": "https://s.ytimg.com/yts/img/favicon-vflz7uhzw.ico", "image": "https://i.ytimg.com/vi/q_kgyJgHtiI/hqdefault.jpg" } [/block]