2
0

PageEditorByHackmd.jsx 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402
  1. import React from 'react';
  2. import PropTypes from 'prop-types';
  3. import loggerFactory from '@alias/logger';
  4. import AppContainer from '../services/AppContainer';
  5. import PageContainer from '../services/PageContainer';
  6. import EditorContainer from '../services/EditorContainer';
  7. import { createSubscribedElement } from './UnstatedUtils';
  8. import HackmdEditor from './PageEditorByHackmd/HackmdEditor';
  9. const logger = loggerFactory('growi:PageEditorByHackmd');
  10. class PageEditorByHackmd extends React.Component {
  11. constructor(props) {
  12. super(props);
  13. this.state = {
  14. isInitialized: false,
  15. isInitializing: false,
  16. // for error
  17. hasError: false,
  18. errorMessage: '',
  19. errorReason: '',
  20. };
  21. this.getHackmdUri = this.getHackmdUri.bind(this);
  22. this.startToEdit = this.startToEdit.bind(this);
  23. this.resumeToEdit = this.resumeToEdit.bind(this);
  24. this.onSaveWithShortcut = this.onSaveWithShortcut.bind(this);
  25. this.hackmdEditorChangeHandler = this.hackmdEditorChangeHandler.bind(this);
  26. this.penpalErrorOccuredHandler = this.penpalErrorOccuredHandler.bind(this);
  27. }
  28. componentWillMount() {
  29. this.props.appContainer.registerComponentInstance('PageEditorByHackmd', this);
  30. }
  31. /**
  32. * return markdown document of HackMD
  33. * @return {Promise<string>}
  34. */
  35. getMarkdown() {
  36. if (!this.state.isInitialized) {
  37. return Promise.reject(new Error('HackmdEditor component has not initialized'));
  38. }
  39. return this.hackmdEditor.getValue();
  40. }
  41. /**
  42. * reset initialized status
  43. */
  44. reset() {
  45. this.setState({ isInitialized: false });
  46. }
  47. getHackmdUri() {
  48. const envVars = this.props.appContainer.getConfig().env;
  49. return envVars.HACKMD_URI;
  50. }
  51. /**
  52. * Start integration with HackMD
  53. */
  54. async startToEdit() {
  55. const { pageContainer } = this.props;
  56. const hackmdUri = this.getHackmdUri();
  57. if (hackmdUri == null) {
  58. // do nothing
  59. return;
  60. }
  61. this.setState({
  62. isInitialized: false,
  63. isInitializing: true,
  64. });
  65. const params = {
  66. pageId: pageContainer.state.pageId,
  67. };
  68. try {
  69. const res = await this.props.appContainer.apiPost('/hackmd.integrate', params);
  70. if (!res.ok) {
  71. throw new Error(res.error);
  72. }
  73. await pageContainer.setState({
  74. pageIdOnHackmd: res.pageIdOnHackmd,
  75. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  76. });
  77. }
  78. catch (err) {
  79. pageContainer.showErrorToastr(err);
  80. this.setState({
  81. hasError: true,
  82. errorMessage: 'GROWI server failed to connect to HackMD.',
  83. errorReason: err.toString(),
  84. });
  85. }
  86. this.setState({
  87. isInitialized: true,
  88. isInitializing: false,
  89. });
  90. }
  91. /**
  92. * Start to edit w/o any api request
  93. */
  94. resumeToEdit() {
  95. this.setState({ isInitialized: true });
  96. }
  97. /**
  98. * Reset draft
  99. */
  100. async discardChanges() {
  101. const { pageContainer } = this.props;
  102. const { pageId } = pageContainer.state;
  103. try {
  104. const res = await this.props.appContainer.apiPost('/hackmd.discard', { pageId });
  105. if (!res.ok) {
  106. throw new Error(res.error);
  107. }
  108. this.props.pageContainer.setState({
  109. hasDraftOnHackmd: false,
  110. pageIdOnHackmd: res.pageIdOnHackmd,
  111. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  112. });
  113. }
  114. catch (err) {
  115. logger.error(err);
  116. pageContainer.showErrorToastr(err);
  117. }
  118. }
  119. /**
  120. * save and update state of containers
  121. * @param {string} markdown
  122. */
  123. async onSaveWithShortcut(markdown) {
  124. const { pageContainer, editorContainer } = this.props;
  125. const optionsToSave = editorContainer.getCurrentOptionsToSave();
  126. try {
  127. // disable unsaved warning
  128. editorContainer.disableUnsavedWarning();
  129. // eslint-disable-next-line no-unused-vars
  130. const { page, tags } = await pageContainer.save(markdown, optionsToSave);
  131. logger.debug('success to save');
  132. pageContainer.showSuccessToastr();
  133. // update state of EditorContainer
  134. editorContainer.setState({ tags });
  135. }
  136. catch (error) {
  137. logger.error('failed to save', error);
  138. pageContainer.showErrorToastr(error);
  139. }
  140. }
  141. /**
  142. * onChange event of HackmdEditor handler
  143. */
  144. async hackmdEditorChangeHandler(body) {
  145. const hackmdUri = this.getHackmdUri();
  146. const { pageContainer, editorContainer } = this.props;
  147. if (hackmdUri == null) {
  148. // do nothing
  149. return;
  150. }
  151. // do nothing if contents are same
  152. if (pageContainer.state.markdown === body) {
  153. return;
  154. }
  155. // enable unsaved warning
  156. editorContainer.enableUnsavedWarning();
  157. const params = {
  158. pageId: pageContainer.state.pageId,
  159. };
  160. try {
  161. await this.props.appContainer.apiPost('/hackmd.saveOnHackmd', params);
  162. }
  163. catch (err) {
  164. logger.error(err);
  165. }
  166. }
  167. penpalErrorOccuredHandler(error) {
  168. const { pageContainer } = this.props;
  169. pageContainer.showErrorToastr(error);
  170. this.setState({
  171. hasError: true,
  172. errorMessage: 'GROWI client failed to connect to GROWI agent for HackMD.',
  173. errorReason: error.toString(),
  174. });
  175. }
  176. renderPreInitContent() {
  177. const hackmdUri = this.getHackmdUri();
  178. const { pageContainer } = this.props;
  179. const {
  180. pageIdOnHackmd, revisionId, revisionIdHackmdSynced, remoteRevisionId, hasDraftOnHackmd,
  181. } = pageContainer.state;
  182. const isPageExistsOnHackmd = (pageIdOnHackmd != null);
  183. const isResume = isPageExistsOnHackmd && hasDraftOnHackmd;
  184. let content;
  185. /*
  186. * HackMD is not setup
  187. */
  188. if (hackmdUri == null) {
  189. content = (
  190. <div>
  191. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is not set up.</p>
  192. </div>
  193. );
  194. }
  195. /*
  196. * Resume to edit or discard changes
  197. */
  198. else if (isResume) {
  199. const isHackmdDocumentOutdated = revisionIdHackmdSynced !== remoteRevisionId;
  200. content = (
  201. <div>
  202. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  203. <p className="text-center"><strong>HackMD has unsaved draft.</strong></p>
  204. { isHackmdDocumentOutdated && (
  205. <div className="panel panel-warning">
  206. <div className="panel-heading"><i className="icon-fw icon-info"></i> DRAFT MAY BE OUTDATED</div>
  207. <div className="panel-body text-center">
  208. The current draft on HackMD is based on&nbsp;
  209. <a href={`?revision=${revisionIdHackmdSynced}`}><span className="label label-default">{revisionIdHackmdSynced.substr(-8)}</span></a>.
  210. <div className="text-center mt-3">
  211. <button
  212. className="btn btn-link btn-view-outdated-draft p-0"
  213. type="button"
  214. disabled={this.state.isInitializing}
  215. onClick={() => { return this.resumeToEdit() }}
  216. >
  217. View the outdated draft on HackMD
  218. </button>
  219. </div>
  220. </div>
  221. </div>
  222. ) }
  223. { !isHackmdDocumentOutdated && (
  224. <div className="text-center hackmd-resume-button-container mb-3">
  225. <button
  226. className="btn btn-success btn-lg waves-effect waves-light"
  227. type="button"
  228. disabled={this.state.isInitializing}
  229. onClick={() => { return this.resumeToEdit() }}
  230. >
  231. <span className="btn-label"><i className="icon-control-end"></i></span>
  232. <span className="btn-text">Resume to edit with HackMD</span>
  233. </button>
  234. </div>
  235. ) }
  236. <div className="text-center hackmd-discard-button-container mb-3">
  237. <button
  238. className="btn btn-default btn-lg waves-effect waves-light"
  239. type="button"
  240. onClick={() => { return this.discardChanges() }}
  241. >
  242. <span className="btn-label"><i className="icon-control-start"></i></span>
  243. <span className="btn-text">Discard changes of HackMD</span>
  244. </button>
  245. </div>
  246. </div>
  247. );
  248. }
  249. /*
  250. * Start to edit
  251. */
  252. else {
  253. const isRevisionOutdated = revisionId !== remoteRevisionId;
  254. content = (
  255. <div>
  256. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  257. <div className="text-center hackmd-start-button-container mb-3">
  258. <button
  259. className="btn btn-info btn-lg waves-effect waves-light"
  260. type="button"
  261. disabled={isRevisionOutdated || this.state.isInitializing}
  262. onClick={() => { return this.startToEdit() }}
  263. >
  264. <span className="btn-label"><i className="icon-paper-plane"></i></span>
  265. Start to edit with HackMD
  266. </button>
  267. </div>
  268. <p className="text-center">Click to clone page content and start to edit.</p>
  269. </div>
  270. );
  271. }
  272. return (
  273. <div className="hackmd-preinit d-flex justify-content-center align-items-center">
  274. {content}
  275. </div>
  276. );
  277. }
  278. render() {
  279. const hackmdUri = this.getHackmdUri();
  280. const { pageContainer } = this.props;
  281. const {
  282. markdown, pageIdOnHackmd, hasDraftOnHackmd,
  283. } = pageContainer.state;
  284. const isPageExistsOnHackmd = (pageIdOnHackmd != null);
  285. const isResume = isPageExistsOnHackmd && hasDraftOnHackmd;
  286. let content;
  287. if (this.state.isInitialized) {
  288. content = (
  289. <HackmdEditor
  290. ref={(c) => { this.hackmdEditor = c }}
  291. hackmdUri={hackmdUri}
  292. pageIdOnHackmd={pageIdOnHackmd}
  293. initializationMarkdown={isResume ? null : markdown}
  294. onChange={this.hackmdEditorChangeHandler}
  295. onSaveWithShortcut={(document) => {
  296. this.onSaveWithShortcut(document);
  297. }}
  298. onPenpalErrorOccured={this.penpalErrorOccuredHandler}
  299. >
  300. </HackmdEditor>
  301. );
  302. }
  303. else {
  304. content = this.renderPreInitContent();
  305. }
  306. return (
  307. <div className="position-relative">
  308. {content}
  309. { this.state.hasError && (
  310. <div className="hackmd-error position-absolute d-flex flex-column justify-content-center align-items-center">
  311. <div className="white-box text-center">
  312. <h2 className="text-warning"><i className="icon-fw icon-exclamation"></i> HackMD Integration failed</h2>
  313. <h4>{this.state.errorMessage}</h4>
  314. <p className="well well-sm text-danger">
  315. {this.state.errorReason}
  316. </p>
  317. <p>
  318. Check your configuration following <a href="https://docs.growi.org/guide/admin-cookbook/integrate-with-hackmd.html">the manual</a>.
  319. </p>
  320. </div>
  321. </div>
  322. ) }
  323. </div>
  324. );
  325. }
  326. }
  327. /**
  328. * Wrapper component for using unstated
  329. */
  330. const PageEditorByHackmdWrapper = (props) => {
  331. return createSubscribedElement(PageEditorByHackmd, props, [AppContainer, PageContainer, EditorContainer]);
  332. };
  333. PageEditorByHackmd.propTypes = {
  334. appContainer: PropTypes.instanceOf(AppContainer).isRequired,
  335. pageContainer: PropTypes.instanceOf(PageContainer).isRequired,
  336. editorContainer: PropTypes.instanceOf(EditorContainer).isRequired,
  337. };
  338. export default PageEditorByHackmdWrapper;